Agent skill

authoring-skills

MUST BE USED when creating, improving, or reviewing Skills. Use PROACTIVELY when user mentions "create a skill", "new skill", "write a skill", "improve skill", "skill description", or "progressive disclosure". Guides through specification-compliant skill design with three-level progressive disclosure.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/authoring-skills

Metadata

Additional technical details for this skill

category
meta
keywords
skill, create, authoring, develop, progressive-disclosure, compliance

SKILL.md

Skill Development

Guides effective Skill creation following the Universal Skills Specification.

Overview

Skills enable agents to work autonomously without human intervention. This skill provides the methodology for creating specification-compliant skills using progressive disclosure, robust scripting, and agentic patterns.

When to Use

  • User mentions "create a skill", "new skill", "write a skill", "improve skill"
  • Reviewing or auditing existing skills for compliance
  • Designing skill architecture with proper agentic patterns

Workflow

  1. Draft Content:

    • Use assets/templates/skill_structure.md for SKILL.md.
    • Use assets/templates/robust_script.py for any Python scripts.
    • Write frontmatter using references/description-templates.md (CRITICAL).
  2. Verify & Refine:

    • Validate against references/compliance-checklist.md.
    • Ensure all paths are relative to project root.
    • Verify that instructions use imperative, third-person language (no "you").

Critical Rules

Resources

  • Core Principles: references/core-principles.md (Philosophy, Directory Structure, Detailed Workflow)
  • Templates:
    • Description: references/description-templates.md
    • Structure: assets/templates/skill_structure.md
    • Script: assets/templates/robust_script.py
    • Evaluation: assets/templates/evaluation_plan.md
  • Guides:
    • references/compliance-checklist.md
    • references/agentic-patterns.md
    • references/security-best-practices.md
    • references/progressive-disclosure.md

Didn't find tool you were looking for?

Be as detailed as possible for better results