stark-ai-de/agent-skills / incubator/skills/skill-maintenance/skill-authoring-review
skill-authoring-review
VerifiedCreate or review Agent Skills with correct SKILL.md frontmatter, trigger descriptions, concise workflow design, progressive disclosure, references, scripts, assets, safety rules, and installability. Use when writing a new skill, improving an existing skill, or validating a public skills repo.
Skill Authoring Review
Goal
Create or review an Agent Skill so another agent can use it reliably with minimal context, clear routing, safe bundled resources, and a concrete output contract.
When to use
- The user asks to create, rewrite, or review a skill.
- A public skill repository needs an installability or quality check.
- A skill has vague triggers, oversized instructions, unsafe scripts, or missing artifacts.
When not to use
- The user is asking to execute a domain workflow that an existing skill already covers.
- The task is ordinary repository review with no skill authoring surface.
- The user only needs installation help; use
skill-installation-support.
Inputs to inspect
SKILL.mdfrontmatter and body.references/,scripts/,assets/, andagents/folders.- README catalog entries and install commands when reviewing a repo.
- Validation output from
npm run validateor an equivalent checker.
Review rubric
Check that name matches the folder, uses lowercase hyphen-case, and appears with a clear description. The description must front-load trigger words because it is the routing surface. The body should state goal, scope, workflow, safety rules, output format, completion criteria, and failure modes.
Read references/skill-quality-rubric.md when doing a scored review. Read references/frontmatter-examples.md when rewriting descriptions.
Workflow
- Inspect the skill path and identify the intended workflow.
- Validate frontmatter syntax, name matching, and description routing quality.
- Check progressive disclosure: keep core steps in
SKILL.mdand move long examples or rubrics into references. - Review scripts for deterministic behavior, clear documentation, and safe defaults.
- Verify output artifacts are concrete enough for a future agent to act on.
- Run available validation commands when working in a repository.
- Return blocking issues first, followed by improvements and a concise rewrite plan.
Safety rules
- Do not copy proprietary or unclear-license skill text into a public skill.
- Do not add scripts that mutate files, call services, or install globally without an approval gate.
- Keep secrets, private repo paths, customer data, and internal hostnames out of examples.
References
Read only when needed:
references/frontmatter-examples.mdreferences/skill-quality-rubric.md
Scripts
No bundled scripts.
Output format
Return:
- Verdict
- Blocking issues
- Non-blocking improvements
- Suggested frontmatter or section rewrites
- Validation result
- Remaining risks
Failure modes
- If the skill purpose is unclear, ask for concrete trigger examples before rewriting.
- If scripts appear destructive or credential-sensitive, stop and call out the risk before suggesting execution.
- If installability cannot be tested locally, say which command could not run and why.
Completion criteria
- Frontmatter is valid and routeable.
- The skill performs one workflow with clear exclusions.
- References and scripts are discoverable but not loaded by default.
- Safety constraints and output artifacts are explicit.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |