Quick Start

What are Agent Skills?

Agent Skills are reusable capability packages for AI coding assistants. Each skill is a folder containing a SKILL.md file (and optional scripts/references) that teaches an AI agent how to perform a specific task.

Unlike system prompts that are always loaded, skills are discovered and loaded on-demand — the agent reads the skill only when it's relevant, saving context window for your actual work.

How This Vault Works

This vault serves two purposes:

Layer	Tool	Purpose
Source of truth	Git + Obsidian	Manage and edit skill files locally
Documentation	VitePress	Render a browsable skill catalog

Agent-Skills/
├── skills/          ← Claude Code loads from here
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── ...
├── docs/            ← VitePress renders from here
│   ├── guide/
│   └── skills/
└── package.json

Prerequisites

• Node.js 18+
• Claude Code CLI installed
• Obsidian (optional, for editing)

Setup

1. Clone the repo

git clone git@github.com:<your-username>/agent-skills.git
cd agent-skills

2. Link skills to Claude Code

Create symlinks so Claude Code can discover the skills:

# Remove existing links (if any)
rm -f ~/.claude/skills/*

# Link each skill
for skill in skills/*/; do
  name=$(basename "$skill")
  ln -s "$(pwd)/$skill" "$HOME/.claude/skills/$name"
done

3. Verify

Open Claude Code and check that skills appear in the system prompt. You can test by asking Claude to invoke a skill-related task (e.g., "review this code").

4. Run the docs site (optional)

npm install
npm run docs:dev

Visit http://localhost:5173 to browse the skill catalog.