Skip to main content

Skills Overview

Skills teach Claude new capabilities through markdown instructions. They are not plugins or code — they are structured prompts that Claude follows when a skill is triggered.

What Is a Skill?

A skill is a directory in .claude/skills/ containing a SKILL.md file with:
  • Frontmatter (name, description) that controls when the skill triggers
  • Instructions that tell Claude exactly what to do, step by step

Skill Categories

Skills are organized by prefix: The repo ships 175+ skills total: ~150 business skills + 25 engineering skills (dev-*).

Business Layer skills

Engineering Layer skills (dev-*)

Derived from oh-my-claudecode (MIT, Yeachan Heo). See Engineering Layer for the full story.

How Triggering Works

The description field in SKILL.md frontmatter tells Claude when to activate the skill. Claude matches user intent against all skill descriptions and picks the best match. Example from fin-daily-pulse:
Key tips for good descriptions:
  • State what the skill does concretely
  • List trigger phrases the user might say
  • Be specific enough to avoid overlapping with other skills

SKILL.md Structure

Creating a New Skill

1. Create the directory and file

2. Write SKILL.md

3. Test it

Open Claude Code and say: “generate a standup summary” — Claude should match your skill’s description and follow the instructions.

Skills vs Agents

Skills are often used by agents. For example, the Flux agent uses fin-daily-pulse, fin-weekly-report, and int-stripe skills to do its work. Routines invoke skills through agents via the runner.