# LLM Agent Skills

A personal collection of reusable skills for LLM coding agents.

Skills are small, focused instruction packs that teach an agent how to perform a
specific workflow consistently. A good skill captures the judgment, conventions,
commands, file layout, and verification steps that should be reused across
projects.

## Goals

- Keep useful agent workflows portable across machines and projects.
- Capture repeatable setup, debugging, writing, and automation patterns.
- Prefer concise instructions over large prompt dumps.
- Make skills easy to inspect, edit, and version.
- Treat skills as living documentation for how I like agents to work.

## Repository Layout

```text
skills/
  README.md
  skills/
    example-skill/
      SKILL.md
```

Each skill should live in its own directory and include a `SKILL.md` file.
Supporting scripts, templates, references, or assets can live next to that file
when they make the skill easier to use.

## Skill Format

A minimal skill should include:

- A short name and description.
- When the skill should be used.
- The workflow the agent should follow.
- Any commands, scripts, or files the agent should prefer.
- Verification steps, if the skill changes files or system state.

## Example

```text
skills/
  macos-setup/
    SKILL.md
    scripts/
      apply-defaults.sh
```

## Writing Principles

- Be specific about triggers.
- Keep instructions operational.
- Prefer checklists and concrete commands.
- Avoid vague personality guidance.
- Include safety notes for destructive or irreversible steps.
- Keep generated artifacts and scratch work out of the repo unless they are part
  of the skill.

## License

Unlicensed for now. Add a license later if these skills become public or shared.