Openskills Skill Authoring

Create and refine OpenSkills-compatible skills (SKILL.md + optional resources) with strong metadata, clear activation triggers, and reliable execution guidance.

majiayu000 010b714 2 files · 2.2 KB Updated 567 repo stars

File contents

OpenSkills Skill Authoring

Use this skill when creating or updating skills under examples/skills or any OpenSkills-compatible skill directory.

Authoring Standard

Each skill directory should include:

  • SKILL.md (required)
  • optional scripts/, references/, assets/

SKILL.md Requirements

  • YAML frontmatter with:
    • name
    • description
  • Body with concise instructions and practical execution flow.
  • Description must include both:
    • what the skill does
    • when to activate it

Writing Guidance

  1. Keep core instructions short; move details to references/.
  2. Prefer deterministic scripts for fragile or repetitive steps.
  3. Include explicit input/output expectations.
  4. Avoid vague names and ambiguous activation phrases.

Validation Flow

  1. Ensure directory name matches skill name semantics.
  2. Verify skill discovery and activation behavior in runtime or example agent.
  3. If scripts are present, verify paths and execution assumptions.

Output Format

  • Skill metadata quality review
  • Instruction clarity review
  • Activation trigger quality review
  • Suggested revisions

majiayu000/claude-skill-registry-data/tree/main/skills/openskills-skill-authoring commit 010b7141e9

Frequently asked questions

npx skillmds add majiayu000/openskills-skill-authoring