develop-skill

Guide Claude Code skill creation and refinement with SKILL.md validation.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/christophevg/c3 --skill develop-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: develop-skill
Source: https://github.com/christophevg/c3/tree/main/skills/develop-skill
Command: npx skills add https://github.com/christophevg/c3 --skill develop-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves inconsistent, hard-to-discover skill behavior by providing a repeatable process for designing, validating, and refining Claude Code skills with clear triggers, structure, and quality checks.

Core Features & Use Cases

  • Six-phase workflow for new skills: guides investigation, research completeness, architecture planning, creation of analysis docs, file authoring, and symlink testing.
  • Four-phase refinement workflow for existing skills: helps analyze current state, identify improvements, implement changes safely, and validate against quality rules.
  • Operational guardrails for C3 vs incubator: adapts steps depending on whether the user is refining within the c3 operational workspace or building in an incubator workspace.

Quick Start

Ask the AI to develop a new skill for your use case by running the develop-skill workflow end to end, including trigger definitions, directory planning, and validation steps.

Frequently Asked Questions about develop-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Claude Code skill with the right triggers and structure?

You create a Claude Code skill by following a six-phase workflow: investigating requirements, researching completeness, planning architecture, creating analysis docs, authoring files, and testing symlinks to ensure discoverable triggers and consistent structure.

What is the best way to refactor existing Claude Code skills safely?

The best way to refactor existing Claude Code skills is using a four-phase refinement workflow that analyzes the current state, identifies improvements, implements changes safely, and validates against quality rules like trigger testing and line-count constraints.

How does progressive disclosure work when building Claude Code skills?

Progressive disclosure in Claude Code skills works by separating core logic from extended context using references, ensuring the main SKILL.md remains concise while delegating detailed instructions to linked files, keeping the skill discoverable and efficient.

Do I need specific YAML frontmatter for my SKILL.md to be valid?

Yes, a valid SKILL.md requires specific YAML frontmatter, strictly enforcing the inclusion of both the name and description fields to ensure the skill is properly parsed and discoverable within the Claude Code environment.

Can I use this skill development workflow in an incubator workspace instead of C3?

Yes, the skill development workflow adapts its operational guardrails based on your context, adjusting steps whether you are refining skills within the C3 operational workspace or building new skills in an incubator workspace.

Why are my Claude Code skill triggers not being discovered during validation?

Your Claude Code skill triggers might not be discovered if the post-change validation process fails, which enforces trigger testing, line-count constraints, and proper directory structure to ensure the skill activates correctly.