mk:llms — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited mk:llms (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
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.
Generate llms.txt files — LLM-friendly markdown indexes of project documentation.
Path convention: Commands below assume cwd is$CLAUDE_PROJECT_DIR(project root). Prefix paths with"$CLAUDE_PROJECT_DIR/"when invoking from subdirectories.
Explicit: /mk:llms [path] [--full]
Operates in Phase 6 (Reflect) or on-demand. Output supports the documenter agent.
| Flag | Effect |
|---|---|
| (no args) | Scan ./docs directory |
path | Scan specific directory |
--full | Also generate llms-full.txt with inline content |
--output path | Custom output location (default: project root) |
--url base | Base URL prefix for links |
Script-first approach — the Python script handles all deterministic work (scanning, extracting, categorizing, generating). Claude only reviews and improves the output.
# Generate llms.txt (script does the heavy lifting)
.claude/skills/.venv/bin/python3 .claude/skills/llms/scripts/generate-llms-txt.py \
--source ./docs [--output .] [--base-url https://example.com/docs] [--full]
# Preview metadata first (Claude reviews before generating)
.claude/skills/.venv/bin/python3 .claude/skills/llms/scripts/generate-llms-txt.py \
--source ./docs --jsongenerate-llms-txt.py --source <path> --json to preview metadata--json to produce llms.txt--full: review llms-full.txt for completeness# {Project Name}
> {Brief project description with essential context.}
## {Section Name}
- [{Doc Title}]({url}): {Brief description}
- [{Another Doc}]({url}): {What this covers}
## Optional
- [{Less Important Doc}]({url}): {Supplementary info}| Reference | When to load | Content |
|---|---|---|
| [llms-txt-spec.md](./references/llms-txt-spec.md) | Step 4 — generating | Full llmstxt.org specification rules |
| Failure | Recovery |
|---|---|
| No .md files found | Report "No documentation found in {path}" |
| No H1 in doc file | Use filename as title, warn user |
| Output path not writable | Suggest alternative path |
.claude/scripts/bin/setup-workflow once from the project root before invoking this skill. Re-run after upgrading the toolkit.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.