md-docs — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited md-docs (Agent Skill) and scored it 91/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 1 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
The text {match} is the classic direct prompt-injection phrasing. Placed in a skill body that the agent reads as trusted instructions, it tries to make the agent abandon its prior rules and follow whatever comes next — a full system-prompt override.
ignore/disregard/forget … previous instructions sentence.Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Manage project documentation by verifying against actual codebase state. Emphasize verification over blind generation — analyze structure, files, and patterns before writing.
AGENTS.md is the universal context file (works with Claude Code, Codex, Kilocode). If the project uses CLAUDE.md, treat it as a symlink to AGENTS.md or migrate content into AGENTS.md and create the symlink:
# If CLAUDE.md exists and AGENTS.md doesn't
mv CLAUDE.md AGENTS.md && ln -sf AGENTS.md CLAUDE.mdWhen this skill references "context files", it means AGENTS.md (and CLAUDE.md if present as symlink).
Verify and fix AGENTS.md against the actual codebase. See references/update-agents.md for the full verification workflow.
ls, cat package.json, cat pyproject.toml, etc.)Generate or refresh README.md from project metadata and structure. See references/update-readme.md for section templates and language-specific patterns.
--preserve: keep custom sections (About, Features), regenerate standard sections (Install, Usage)Update existing CONTRIBUTING.md only — never auto-create. See references/update-contributing.md.
Create AGENTS.md from scratch for projects without documentation. See references/init-agents.md.
All workflows support:
--dry-run: preview changes without writing--preserve: keep existing structure, fix inaccuracies only--minimal: quick pass, high-level structure only--thorough: deep analysis of all filesBefore overwriting, back up existing files:
cp AGENTS.md AGENTS.md.backup
cp README.md README.md.backupNever delete backups automatically.
After every operation, display a summary:
✓ Updated AGENTS.md
- Fixed build command
- Added new directory to structure
✓ Updated README.md
- Added installation section
- Updated badges
⊘ CONTRIBUTING.md not found (skipped)~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.