create-skill

Onboarding Awareness (CHECK BEFORE STARTING)

Before creating a skill, AI MUST check stats.pending_onboarding for learn_skills:

Pre-Flight Check (MANDATORY)

Check if learn_skills is in stats.pending_onboarding. If present AND this is user's FIRST skill:

💡 Before creating your first skill, would you like a quick 10-minute tutorial
on what makes workflows "skill-worthy"? It covers:
- The 3-criteria skill-worthiness framework
- How skills are structured (SKILL.md, scripts/, references/)
- How AI triggers skills automatically

Say 'learn skills' to start the tutorial, or 'skip' to create directly.

If user says 'skip': Proceed with skill creation but add this note at the end:

💡 Tip: Run 'learn skills' later to understand the skill system deeply.

If learn_skills NOT in pending_onboarding: Proceed normally without suggestion.

Anti-Pattern Detection

If user is creating similar items (report-jan, report-feb, report-mar pattern):

💡 I notice you're creating similar items. This is a perfect use case for
a SKILL instead of multiple builds/files. Want to 'learn skills' first
to understand how to capture this as a reusable workflow?

---

Create Skill

This skill provides guidance for creating effective skills.

About Skills

Skills are modular, self-contained packages that extend Claude's capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasks—they transform Claude from a general-purpose agent into a specialized agent equipped with procedural knowledge that no model can fully possess.

What Skills Provide

1. Specialized workflows - Multi-step procedures for specific domains
2. Tool integrations - Instructions for working with specific file formats or APIs
3. Domain expertise - Company-specific knowledge, schemas, business logic
4. Bundled resources - Scripts, references, and assets for complex and repetitive tasks

Core Principles