$npx -y skills add DNYoussef/context-cascade --skill skill-builder/*============================================================================*/ /* SKILL BUILDER SKILL :: VERILINGUA x VERIX EDITION */ /*============================================================================*/
| 1 | /*============================================================================*/ |
| 2 | /* SKILL BUILDER SKILL :: VERILINGUA x VERIX EDITION */ |
| 3 | /*============================================================================*/ |
| 4 | |
| 5 | --- |
| 6 | name: Skill Builder |
| 7 | version: 1.0.0 |
| 8 | description: | |
| 9 | [assert|neutral] Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, gene [ground:given] [conf:0.95] [state:confirmed] |
| 10 | category: foundry |
| 11 | tags: |
| 12 | - general |
| 13 | author: system |
| 14 | cognitive_frame: |
| 15 | primary: aspectual |
| 16 | goal_analysis: |
| 17 | first_order: "Execute Skill Builder workflow" |
| 18 | second_order: "Ensure quality and consistency" |
| 19 | third_order: "Enable systematic foundry processes" |
| 20 | --- |
| 21 | |
| 22 | /*----------------------------------------------------------------------------*/ |
| 23 | /* S0 META-IDENTITY */ |
| 24 | /*----------------------------------------------------------------------------*/ |
| 25 | |
| 26 | [define|neutral] SKILL := { |
| 27 | name: "Skill Builder", |
| 28 | category: "foundry", |
| 29 | version: "1.0.0", |
| 30 | layer: L1 |
| 31 | } [ground:given] [conf:1.0] [state:confirmed] |
| 32 | |
| 33 | /*----------------------------------------------------------------------------*/ |
| 34 | /* S1 COGNITIVE FRAME */ |
| 35 | /*----------------------------------------------------------------------------*/ |
| 36 | |
| 37 | [define|neutral] COGNITIVE_FRAME := { |
| 38 | frame: "Aspectual", |
| 39 | source: "Russian", |
| 40 | force: "Complete or ongoing?" |
| 41 | } [ground:cognitive-science] [conf:0.92] [state:confirmed] |
| 42 | |
| 43 | ## Kanitsal Cerceve (Evidential Frame Activation) |
| 44 | Kaynak dogrulama modu etkin. |
| 45 | |
| 46 | /*----------------------------------------------------------------------------*/ |
| 47 | /* S2 TRIGGER CONDITIONS */ |
| 48 | /*----------------------------------------------------------------------------*/ |
| 49 | |
| 50 | [define|neutral] TRIGGER_POSITIVE := { |
| 51 | keywords: ["Skill Builder", "foundry", "workflow"], |
| 52 | context: "user needs Skill Builder capability" |
| 53 | } [ground:given] [conf:1.0] [state:confirmed] |
| 54 | |
| 55 | /*----------------------------------------------------------------------------*/ |
| 56 | /* S3 CORE CONTENT */ |
| 57 | /*----------------------------------------------------------------------------*/ |
| 58 | |
| 59 | ## Phase 0: Expertise Loading |
| 60 | |
| 61 | |
| 62 | # Skill Builder |
| 63 | |
| 64 | ## Kanitsal Cerceve (Evidential Frame Activation) |
| 65 | Kaynak dogrulama modu etkin. |
| 66 | |
| 67 | |
| 68 | |
| 69 | ## What This Skill Does |
| 70 | |
| 71 | Creates production-ready Claude Code Skills with proper YAML frontmatter, progressive disclosure architecture, and complete file/folder structure. This skill guides you through building skills that Claude can autonomously discover and use across all surfaces (Claude.ai, Claude Code, SDK, API). |
| 72 | |
| 73 | ## Prerequisites |
| 74 | |
| 75 | - Claude Code 2.0+ or Claude.ai with Skills support |
| 76 | - Basic understanding of Markdown and YAML |
| 77 | - Text editor or IDE |
| 78 | |
| 79 | ## Quick Start |
| 80 | |
| 81 | ### Creating Your First Skill |
| 82 | |
| 83 | ```bash |
| 84 | # 1. Create skill directory (MUST be at top level, NOT in subdirectories!) |
| 85 | mkdir -p ~/.claude/skills/my-first-skill |
| 86 | |
| 87 | # 2. Create SKILL.md with proper format |
| 88 | cat > ~/.claude/skills/my-first-skill/SKILL.md << 'EOF' |
| 89 | --- |
| 90 | name: "My First Skill" |
| 91 | description: "Brief description of what this skill does and when Claude should use it. Maximum 1024 characters." |
| 92 | --- |
| 93 | |
| 94 | # My First Skill |
| 95 | |
| 96 | ## What This Skill Does |
| 97 | [Your instructions here] |
| 98 | |
| 99 | ## Quick Start |
| 100 | [Basic usage] |
| 101 | EOF |
| 102 | |
| 103 | # 3. Verify skill is detected |
| 104 | # Restart Claude Code or refresh Claude.ai |
| 105 | ``` |
| 106 | |
| 107 | --- |
| 108 | |
| 109 | ## Complete Specification |
| 110 | |
| 111 | ### 📋 YAML Frontmatter (REQUIRED) |
| 112 | |
| 113 | Every SKILL.md **must** start with YAML frontmatter containing exactly two required fields: |
| 114 | |
| 115 | ```yaml |
| 116 | --- |
| 117 | name: "Skill Name" # REQUIRED: Max 64 chars |
| 118 | description: "What this skill does # REQUIRED: Max 1024 chars |
| 119 | and when Claude should use it." # Include BOTH what & when |
| 120 | --- |
| 121 | ``` |
| 122 | |
| 123 | #### Field Requirements |
| 124 | |
| 125 | **`name`** (REQUIRED): |
| 126 | - **Type**: String |
| 127 | - **Max Length**: 64 characters |
| 128 | - **Format**: Human-friendly display name |
| 129 | - **Usage**: Shown in skill lists, UI, and loaded into Claude's system prompt |
| 130 | - **Best Practice**: Use Title Case, be concise and descriptive |
| 131 | - **Examples**: |
| 132 | - ✅ "API Documentation Generator" |
| 133 | - ✅ "React Component Builder" |
| 134 | - ✅ "Database Schema Designer" |
| 135 | - ❌ "skill-1" (not descriptive) |
| 136 | - ❌ "This is a very long skill name that exceeds sixty-four characters" (too long) |
| 137 | |
| 138 | **`description`** (REQUIRED): |
| 139 | - **Type**: String |
| 140 | - **Max Length**: 1024 characters |
| 141 | - **Format**: Plain text or minimal markdown |
| 142 | - **Content**: MUST include: |
| 143 | 1. **What** the skill does (functionality) |
| 144 | 2. **When** Claude should invoke it (trigger conditions) |
| 145 | - **Usage**: Loaded into Claude's system prompt for autonomous matching |
| 146 | - **Best Practice**: Front-load key trigger words, be specific about use cases |
| 147 | - **Examples**: |
| 148 | - ✅ "Generate OpenAPI 3.0 documentation from Express.js routes. Use when creating API docs, do |