skill-creator

n4vysh's avatarfrom n4vysh

Create effective skills. Use when creating or updating skills.

⭐5stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026

When & Why to Use This Skill

The Skill Creator is a specialized framework designed to standardize and optimize the development of Claude agent skills. It provides developers with a rigorous set of principles, structural templates, and best practices to ensure that agentic capabilities are concise, maintainable, and highly effective. By enforcing consistent naming conventions and architectural patterns like progressive disclosure, it helps developers build more reliable AI tools while minimizing context noise.

Use Cases

  • Standardizing Agent Development: Establish a consistent structure and naming convention across a library of skills to improve team collaboration and code maintainability.
  • Optimizing Instruction Clarity: Use the 'Concise' and 'Progressive Disclosure' principles to ensure AI agents receive only the most relevant information, reducing token waste and improving task accuracy.
  • Rapid Skill Bootstrapping: Leverage the provided SKILL.md template and checklist to quickly create new, production-ready agent capabilities from scratch.
  • Quality Assurance and Auditing: Apply the anti-pattern guide and validation checklist to refine existing skills, ensuring they meet professional standards for performance and reliability.
nameskill-creator
descriptionCreate effective skills. Use when creating or updating skills.
licenseUNLICENSE
compatibilityopencode

Skill Creator

Principles

  • Concise: Only add context AI doesn't have.
  • Progressive disclosure: Metadata → SKILL.md → Resources
  • Appropriate freedom: High for flexible, low for fragile tasks.

Structure

skill-name/
├── SKILL.md (required)
└── Optional: scripts/, references/, assets/
  • SKILL.md:
    • name: lowercase, hyphens, max 64 chars
    • description: max 1024 chars, third person, what + when
    • compatibility: opencode
    • Body: under 500 lines
  • Naming: Gerund form (processing-pdfs, analyzing-data)
  • Description: Extract PDF text. Use when working with PDFs.

Formatting

  • 80 chars guideline: Exceptions: URLs, code, tables
  • Paths: Forward slashes (scripts/file.py)
  • Terminology: Consistent throughout

Patterns

Progressive disclosure:

## Quick start

[Instructions]

## Advanced

See [ADVANCED.md](ADVANCED.md)

Workflows with checklist:

- [ ] Analyze
- [ ] Validate
- [ ] Execute
  • Feedback loops: Validate → fix → repeat
  • Templates: ALWAYS use: [template] or Adapt as needed: [...]
  • Examples: Provide input/output pairs

Anti-Patterns

❌ Windows paths, vague descriptions, many options ❌ Time-sensitive info, nested references

Development

  1. Complete task, notice repeated context
  2. Create skill with AI
  3. Test, iterate

Template

---
name: skill-name
description: What it does. Use when [trigger].
license: UNLICENSE
compatibility: opencode
---

# Skill Name

[Instructions]

Checklist:

  • Description under 80 chars, third person
  • Body under 500 lines, 80 char guideline
  • Consistent terminology
  • References one level deep
  • Tested with real usage