# Agent Skills Sample

A starter template demonstrating the **7-Skill System** for Claude Code, inspired by [Alex Sprogis' guide](https://www.youtube.com/watch?v=AAC4npr_qdk).

## What Are Agent Skills?

Agent Skills are markdown files that give AI coding agents procedural knowledge. One file, and your agent works like a specialist instead of a generalist.

```
.claude/skills/
├── requirements/SKILL.md   # Product Manager
├── architecture/SKILL.md   # Tech Lead
├── frontend/SKILL.md       # Frontend Dev (sub-agent)
├── backend/SKILL.md        # Backend Dev (sub-agent)
├── qa/SKILL.md             # QA Engineer (sub-agent)
├── deploy/SKILL.md         # DevOps
└── help/SKILL.md           # Guide
```

## Quick Start

```bash
# Clone
git clone https://git.hofmanns.tech/hofmann/agent-skills-sample.git
cd agent-skills-sample

# Install
npm install

# Start building with skills
claude
> /help                    # Learn the workflow
> /requirements login      # Define a feature
> /architecture PROJ-001   # Design it
> /frontend PROJ-001       # Build the UI
> /backend PROJ-001        # Build the API
> /qa PROJ-001             # Test it
> /deploy production       # Ship it
```

## Creating Your Own Skills

```yaml
---
name: my-skill
description: What it does and when to trigger it
disable-model-invocation: true   # User-only (for side effects)
context: fork                     # Run in isolated sub-agent
allowed-tools: Read, Write, Bash  # Restrict tool access
---

# Skill Instructions

Your instructions here. Use $ARGUMENTS for user input.
Use !`command` for dynamic context injection.
```

## Key Concepts

| Concept | Description |
|---------|-------------|
| `$ARGUMENTS` | User input after skill name: `/deploy staging` -> "staging" |
| `context: fork` | Runs in isolated sub-agent (own context window) |
| `disable-model-invocation` | Only user can trigger (prevents accidental runs) |
| `!`command`` | Injects command output before skill runs |
| `allowed-tools` | Restricts which tools the skill can use |

## Resources

- [skills.sh](https://skills.sh) — Marketplace with 80K+ skills
- [Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code) — Official documentation
- [Video Guide](https://www.youtube.com/watch?v=AAC4npr_qdk) — Alex Sprogis' tutorial

## License

MIT