SKILL.md
$27
skill-name/
SKILL.md
scripts/ optional deterministic helpers
references/ optional docs loaded only when needed
assets/ optional output resources/templates
agents/ optional UI metadataGood SKILL.md
---
name: pdf-tools
description: "Inspect, split, merge, OCR, redact, or convert PDFs with local CLI tools."
---
# PDF tools
Use for PDF manipulation. Prefer deterministic scripts for page edits.
## Workflow
1. Inspect file/page count.
2. Choose exact operation.
3. Write output beside input unless user asked otherwise.
4. Render/verify changed pages.Edit workflow
- Read existing skill and nearby resource names.
- Remove generic advice the base model already knows.
- Keep brittle command syntax, auth caveats, safety rules, and validation.
- Replace tables with bullets unless a table is clearly needed.
- Relax prose; fragments ok.
- Validate frontmatter and run any script tests touched.
Validation
python skills/skill-creator/scripts/quick_validate.py skills/<name>
python - <<'PY'
from pathlib import Path
import yaml
for p in Path("skills").glob("*/SKILL.md"):
text=p.read_text()
if not text.startswith("---\n"):
raise SystemExit(f"missing frontmatter: {p}")
fm=text.split("---",2)[1]
yaml.safe_load(fm)
print("ok")
PYquick_validate.py is conservative; repo-local frontmatter may allow keys beyond public skill bundles.