Skills: Instructions file for Claude Code

CLAUDE.md

This is an agent skills repository.

Requirements

Node.js ≥ 18, pnpm ≥ 9

Repository Structure

kriscard-skills/
├── skills/
│   ├── dev/                     # Development skills
│   ├── dotfiles/                # Shell and dotfiles skills
│   ├── learning/                # Learning and knowledge capture
│   ├── obsidian/                # Obsidian vault management
│   ├── productivity/            # Productivity and workflow skills
│   └── writing/                 # Writing and content skills
├── scripts/
│   └── validate-skills.mjs      # Validate skill structure and references
└── package.json

Skill Structure

Each skill is a directory with a SKILL.md file:

skills/<category>/<name>/
├── SKILL.md                     # Required — frontmatter + instructions
└── references/                  # Optional — lazy-loaded reference files
    └── <topic>.md

Frontmatter rules (verified against official docs)

Skills (SKILL.md):

• Required: name, description
• Recommended: trigger phrases in description ("Use when..." / "Make sure to use this skill whenever...")
• Optional: paths (glob auto-activation), argument-hint, disable-model-invocation, user-invocable, allowed-tools, effort
• Description budget: combined description + when_to_use truncated at 1,536 characters

Development Commands

pnpm install                     # First-time setup
pnpm run validate                # Validate skills, types, and formatting
pnpm run format                  # Format all files

Adding a Skill

1. Create skills/<category>/<name>/SKILL.md
2. Run pnpm run validate to verify its structure, frontmatter, and references
3. Install or update the collection with npx skills@latest add kriscard/Skills -g

Naming Conventions

• Category directories: kebab-case (e.g., developer-tools)
• Skill directories: kebab-case (e.g., blog-writer/)
• Skill names must be unique across the entire skills/ tree and across globally installed skills