Skip to content

aiskillstore/marketplace / skills/aaronabuusama/create-skill

create-skill

Verified

Guide for creating new skills in Kai's personal AI infrastructure. Use when user wants to create, update, or structure a new skill that extends capabilities with specialized knowledge, workflows, or tool integrations. Follows both Anthropic skill standards and PAI-specific patterns.

Create Skill - Skill Creation Framework

When to Activate This Skill

  • "Create a new skill for X"
  • "Build a skill that does Y"
  • "Add a skill for Z"
  • "Update/improve existing skill"
  • "Structure a skill properly"
  • User wants to extend Kai's capabilities

Core Skill Creation Workflow

Step 1: Understand the Purpose

Ask these questions:

  • What does this skill do? (Clear, specific purpose)
  • When should it activate? (Trigger conditions)
  • What tools/commands does it use? (Dependencies)
  • Is it simple or complex? (Determines structure)

Step 2: Choose Skill Type

Simple Skill (SKILL.md only):

  • Single focused capability
  • Minimal dependencies
  • Quick reference suffices
  • Examples: fabric-patterns, youtube-extraction

Complex Skill (SKILL.md + CLAUDE.md + supporting files):

  • Multi-step workflows
  • Extensive context needed
  • Multiple sub-components
  • Examples: development, website, consulting

Step 3: Create Directory Structure

# Simple skill
${PAI_DIR}/skills/[skill-name]/
└── SKILL.md

# Complex skill
${PAI_DIR}/skills/[skill-name]/
├── SKILL.md           # Quick reference
├── CLAUDE.md          # Full context
└── [subdirectories]/  # Supporting resources

Step 4: Write SKILL.md (Required)

Use this structure:

---
name: skill-name
description: Clear description of what skill does and when to use it. Should match activation triggers.
---

# Skill Name

## When to Activate This Skill
- Trigger condition 1
- Trigger condition 2
- User phrase examples

## [Main Content Sections]
- Core workflow
- Key commands
- Examples
- Best practices

## Supplementary Resources
For detailed context: `read ${PAI_DIR}/skills/[skill-name]/CLAUDE.md`

Step 5: Write CLAUDE.md (If Complex)

Include:

  • Comprehensive methodology
  • Detailed workflows
  • Component documentation
  • Advanced usage patterns
  • Integration instructions
  • Troubleshooting guides

Step 6: Add to Global Context

Update ${PAI_DIR}/global/KAI.md available_skills section to include the new skill so it shows up in the system prompt.

Step 7: Test the Skill

  1. Trigger it with natural language
  2. Verify it loads correctly
  3. Check all references work
  4. Validate against examples

Skill Naming Conventions

  • Lowercase with hyphens: create-skill, web-scraping
  • Descriptive, not generic: fabric-patterns not text-processing
  • Action or domain focused: ai-image-generation, chrome-devtools

Description Best Practices

Your description should:

  • Clearly state what the skill does
  • Include trigger phrases (e.g., "USE WHEN user says...")
  • Mention key tools/methods used
  • Be concise but complete (1-3 sentences)

Good examples:

  • "Multi-source comprehensive research using perplexity-researcher, claude-researcher, and gemini-researcher agents. Launches up to 10 parallel research agents for fast results. USE WHEN user says 'do research', 'research X', 'find information about'..."
  • "Chrome DevTools MCP for web application debugging, visual testing, and browser automation. The ONLY acceptable way to debug web apps - NEVER use curl, fetch, or wget."

Templates Available

  • simple-skill-template.md - For straightforward capabilities
  • complex-skill-template.md - For multi-component skills
  • skill-with-agents-template.md - For skills using sub-agents

Supplementary Resources

For complete guide with examples: read ${PAI_DIR}/skills/create-skill/CLAUDE.md For templates: ls ${PAI_DIR}/skills/create-skill/templates/

Key Principles

  1. Progressive disclosure: SKILL.md = quick reference, CLAUDE.md = deep dive
  2. Clear activation triggers: User should know when skill applies
  3. Executable instructions: Imperative/infinitive form (verb-first)
  4. Context inheritance: Skills inherit global context automatically
  5. No duplication: Reference global context, don't duplicate it
  6. Self-contained: Skill should work independently
  7. Discoverable: Description enables Kai to match user intent
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall