# Skill Builder > Skill Builder - Skill: `dnyoussef/skill-builder` (Agent Skill, multi-file: 5 files) - Install (CLI): `npx skillmds@latest add dnyoussef/skill-builder` - Raw SKILL.md: https://api.skillmd.com/api/skills/dnyoussef/skill-builder/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: DNYoussef (https://skillmd.com/u/dnyoussef) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/dnyoussef/skill-builder --- /*============================================================================*/ /* SKILL BUILDER SKILL :: VERILINGUA x VERIX EDITION */ /*============================================================================*/ --- name: Skill Builder version: 1.0.0 description: | [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] category: foundry tags: - general author: system cognitive_frame: primary: aspectual goal_analysis: first_order: "Execute Skill Builder workflow" second_order: "Ensure quality and consistency" third_order: "Enable systematic foundry processes" --- /*----------------------------------------------------------------------------*/ /* S0 META-IDENTITY */ /*----------------------------------------------------------------------------*/ [define|neutral] SKILL := { name: "Skill Builder", category: "foundry", version: "1.0.0", layer: L1 } [ground:given] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S1 COGNITIVE FRAME */ /*----------------------------------------------------------------------------*/ [define|neutral] COGNITIVE_FRAME := { frame: "Aspectual", source: "Russian", force: "Complete or ongoing?" } [ground:cognitive-science] [conf:0.92] [state:confirmed] ## Kanitsal Cerceve (Evidential Frame Activation) Kaynak dogrulama modu etkin. /*----------------------------------------------------------------------------*/ /* S2 TRIGGER CONDITIONS */ /*----------------------------------------------------------------------------*/ [define|neutral] TRIGGER_POSITIVE := { keywords: ["Skill Builder", "foundry", "workflow"], context: "user needs Skill Builder capability" } [ground:given] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S3 CORE CONTENT */ /*----------------------------------------------------------------------------*/ ## Phase 0: Expertise Loading # Skill Builder ## Kanitsal Cerceve (Evidential Frame Activation) Kaynak dogrulama modu etkin. ## What This Skill Does 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). ## Prerequisites - Claude Code 2.0+ or Claude.ai with Skills support - Basic understanding of Markdown and YAML - Text editor or IDE ## Quick Start ### Creating Your First Skill ```bash # 1. Create skill directory (MUST be at top level, NOT in subdirectories!) mkdir -p ~/.claude/skills/my-first-skill # 2. Create SKILL.md with proper format cat > ~/.claude/skills/my-first-skill/SKILL.md << 'EOF' --- name: "My First Skill" description: "Brief description of what this skill does and when Claude should use it. Maximum 1024 characters." --- # My First Skill ## What This Skill Does [Your instructions here] ## Quick Start [Basic usage] EOF # 3. Verify skill is detected # Restart Claude Code or refresh Claude.ai ``` --- ## Complete Specification ### 📋 YAML Frontmatter (REQUIRED) Every SKILL.md **must** start with YAML frontmatter containing exactly two required fields: ```yaml --- name: "Skill Name" # REQUIRED: Max 64 chars description: "What this skill does # REQUIRED: Max 1024 chars and when Claude should use it." # Include BOTH what & when --- ``` #### Field Requirements **`name`** (REQUIRED): - **Type**: String - **Max Length**: 64 characters - **Format**: Human-friendly display name - **Usage**: Shown in skill lists, UI, and loaded into Claude's system prompt - **Best Practice**: Use Title Case, be concise and descriptive - **Examples**: - ✅ "API Documentation Generator" - ✅ "React Component Builder" - ✅ "Database Schema Designer" - ❌ "skill-1" (not descriptive) - ❌ "This is a very long skill name that exceeds sixty-four characters" (too long) **`description`** (REQUIRED): - **Type**: String - **Max Length**: 1024 characters - **Format**: Plain text or minimal markdown - **Content**: MUST include: 1. **What** the skill does (functionality) 2. **When** Claude should invoke it (trigger conditions) - **Usage**: Loaded into Claude's system prompt for autonomous matching - **Best Practice**: Front-load key trigger words, be specific about use cases - **Examples**: - ✅ "Generate OpenAPI 3.0 documentation from Express.js routes. Use when creating API docs, documenting endpoints, or building API specifications." - ✅ "Create React functional components with TypeScript, hooks, and tests. Use when scaffolding new components or converting class components." - ❌ "A comprehensive guide to API documentation" (no "when" clause) - ❌ "Documentation tool" (too vague) #### YAML Formatting Rules ```yaml --- # ✅ CORRECT: Simple string name: "API Builder" description: "Creates REST APIs with Express and TypeScript." # ✅ CORRECT: Multi-line description name: "Full-Stack Generator" description: "Generates full-stack applications with React frontend and Node.js backend. Use when starting new projects or scaffolding applications." # ✅ CORRECT: Special characters quoted name: "JSON:API Builder" description: "Creates JSON:API compliant endpoints: pagination, filtering, relationships." # ❌ WRONG: Missing quotes with special chars name: API:Builder # YAML parse error! # ❌ WRONG: Extra fields (ignored but discouraged) name: "My Skill" description: "My description" version: "1.0.0" # NOT part of spec author: "Me" # NOT part of spec tags: ["dev", "api"] # NOT part of spec --- ``` **Critical**: Only `name` and `description` are used by Claude. Additional fields are ignored. --- ### 📂 Directory Structure #### Minimal Skill (Required) ``` ~/.claude/skills/ # Personal skills location └── my-skill/ /*----------------------------------------------------------------------------*/ /* S4 SUCCESS CRITERIA */ /*----------------------------------------------------------------------------*/ [define|neutral] SUCCESS_CRITERIA := { primary: "Skill execution completes successfully", quality: "Output meets quality thresholds", verification: "Results validated against requirements" } [ground:given] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S5 MCP INTEGRATION */ /*----------------------------------------------------------------------------*/ [define|neutral] MCP_INTEGRATION := { memory_mcp: "Store execution results and patterns", tools: ["mcp__memory-mcp__memory_store", "mcp__memory-mcp__vector_search"] } [ground:witnessed:mcp-config] [conf:0.95] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S6 MEMORY NAMESPACE */ /*----------------------------------------------------------------------------*/ [define|neutral] MEMORY_NAMESPACE := { pattern: "skills/foundry/Skill Builder/{project}/{timestamp}", store: ["executions", "decisions", "patterns"], retrieve: ["similar_tasks", "proven_patterns"] } [ground:system-policy] [conf:1.0] [state:confirmed] [define|neutral] MEMORY_TAGGING := { WHO: "Skill Builder-{session_id}", WHEN: "ISO8601_timestamp", PROJECT: "{project_name}", WHY: "skill-execution" } [ground:system-policy] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S7 SKILL COMPLETION VERIFICATION */ /*----------------------------------------------------------------------------*/ [direct|emphatic] COMPLETION_CHECKLIST := { agent_spawning: "Spawn agents via Task()", registry_validation: "Use registry agents only", todowrite_called: "Track progress with TodoWrite", work_delegation: "Delegate to specialized agents" } [ground:system-policy] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* S8 ABSOLUTE RULES */ /*----------------------------------------------------------------------------*/ [direct|emphatic] RULE_NO_UNICODE := forall(output): NOT(unicode_outside_ascii) [ground:windows-compatibility] [conf:1.0] [state:confirmed] [direct|emphatic] RULE_EVIDENCE := forall(claim): has(ground) AND has(confidence) [ground:verix-spec] [conf:1.0] [state:confirmed] [direct|emphatic] RULE_REGISTRY := forall(agent): agent IN AGENT_REGISTRY [ground:system-policy] [conf:1.0] [state:confirmed] /*----------------------------------------------------------------------------*/ /* PROMISE */ /*----------------------------------------------------------------------------*/ [commit|confident] SKILL BUILDER_VERILINGUA_VERIX_COMPLIANT [ground:self-validation] [conf:0.99] [state:confirmed]