Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/extra-org/extra/skill-authoringnpx skills add extra-org/extra --skill skill-authoringgit clone --depth 1 https://github.com/extra-org/extraWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00042 | $0.01064 |
| Opus 5 | $0.00021 | $0.00532 |
| Sonnet 5 | $0.00008 | $0.00213 |
| Haiku 4.5 | $0.00004 | $0.00106 |
Grade A, and why
skill-authoring scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Skill: Skill Authoring
Purpose
Define how to create new skill files so the .ai/skills/ system stays
consistent, operational, and trustworthy. A skill is a short, repeatable
playbook — not an essay.
When to Use This Skill
- Creating a new skill file in
.ai/skills/. - Substantially restructuring an existing skill.
- Reviewing a proposed skill for quality and consistency.
Files to Read First
AGENTS.md(skills system + architecture rules a skill must not contradict)..ai/README.md(the index a new skill must be added to).- An existing high-quality skill as a model (e.g.
.ai/skills/code-review.md). - Any
docs//ADR the new skill will reference.
Core Principles
- Operational, not academic. A skill tells an agent what to do, step by step. No long prose.
- Task-oriented and repeatable. Focus on behavior an agent will repeat.
- Consistent structure. Every skill uses the standard section set (below).
- Must include when to use it, files to read first, rules, process, checklist, and common mistakes.
- Never contradicts
AGENTS.md, the docs, or ADRs. If it would, you need an ADR/doc change first, not a skill that diverges. - References, not duplicates. Link to the authoritative doc/ADR rather than
copying its content (which will drift). This is also why skills live only in
.ai/— never copy them into tool-specific folders. - Short enough to be used. If it's too long to read before a task, trim it.
- Includes validation commands (e.g.
make check).
Process
- Confirm the gap. Ensure no existing skill already covers the area; prefer improving one over adding a near-duplicate.
- Copy the template below into
.ai/skills/<name>.md. - Fill every section with concrete, project-specific instructions (mention real layers, files, and commands — not generic advice).
- Cross-check against
AGENTS.md/ADRs for contradictions. - Add it to
.ai/README.mdindex and, if it maps to a task type, to theAGENTS.mdskills mapping. - Validate formatting with
make check(Markdown only → still run it).
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 127 lines · 42 tokens per session scan A 1d9b86da68d3
skill-authoring is a skill published in the GitHub repository extra-org/extra (108 stars, last pushed 4d ago), licensed MIT. It adds 42 tokens to every session and 1,064 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
skill-doc-delivery
Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable deliverables.
peekaboo
Capture and automate macOS UI with the Peekaboo CLI.
powerpoint
Create designed, editable PowerPoint .pptx presentations with PptxGenJS. Use when the user asks to create, generate, update, or inspect a deck, slide deck, presentation, or .pptx file.
oracle
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
skill-intent-contract
Use when starting a complex or ambiguous task that risks scope drift.
skill-security-framing
URL validation and content sanitization for untrusted sources — use when handling external input safely.