Index of every page on this site: llms.txt
All skills
hagaiw avatar

/skill-author

@33ac0e9
Run it yourself

Use when an author needs to create, review, audit, or improve an Agent Skill and its supporting references or scripts.

  • 6 files
  • 13.3 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/hagaiw/skillroll/skill-author

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈33 tokens for metadata: the name and description. ≈619 when used: this file. ≈2.8k more on demand in 5 files.

Description uses 1.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈133 characters, or 1.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Author Agent Skills

Create a skill that improves one coherent kind of work without constraining unrelated requests. Start from the user's intended outcome and the decisions a capable agent would not reliably make without added guidance.

Audit a skill

Work directly from skill text, excerpts, and concrete facts the user supplies. Read a target file only when its content is needed and its path is available; never invent a path or delay a bounded review merely to request material already present. If the missing content prevents the requested work, name that gap and ask for it.

An audit is not automatically a rewrite request. For each structural finding, return:

  1. the implicated guidance and plausible observable risk;
  2. the evidence status and a focused realistic eval that could test the risk;
  3. only then, a possible localized repair if the evidence supports one.

Do not claim a behavioral violation without a completed realistic run. Place any supported repair beside the capability or decision it governs rather than adding a detached override.

Author or improve a skill

Keep discovery precise: use a concise name and a description that says what the skill does and when it applies. Put essential routing, consequential boundaries, and the normal workflow in SKILL.md. Move substantial conditional knowledge to linked references and repeated deterministic operations to scripts.

Match specificity to risk. State exact permission, safety, evidence, interface, and stop requirements when deviation has a concrete cost. Otherwise specify the outcome and decision criteria rather than one mandatory choreography. Preserve the user's scope and do not treat task authorization as permission for unrelated external effects.

Read skill authoring context for the canonical quality standard, audit questions, repair method, and validation boundary.

For a design-only request, label the response as a proposal. Distinguish structural validation, deterministic script tests, and live behavioral evidence as separate checks, and say which were not run rather than implying that the proposed package was implemented or tested.

When improving an existing skill, distinguish a structural concern from an observed behavioral failure. Integrate the smallest supported repair into the responsible section and surrounding vocabulary. Validate structure and scripts; use a realistic behavioral eval when the claim is about model behavior.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 33ac0e9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated 2 weeks ago

README badge

README badge for hagaiw/skillroll/skill-author