> ## Documentation Index
> Fetch the complete documentation index at: https://bintzgavin-apastra-14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills overview

> Apastra skills are SKILL.md files that teach your IDE agent domain-specific PromptOps workflows — how to evaluate, baseline, scaffold, validate, and ship AI prompts.

## What are skills?

Skills are `SKILL.md` files that you install into your IDE agent. Once installed, your agent understands the full apastra file-based protocol: how to read prompt specs, run evaluations, compare against baselines, and gate quality — all without external infrastructure.

Each skill is a focused, composable unit of knowledge. Install only the skills you need, or install everything at once.

<Note>
  Skills work with any agent that supports SKILL.md-based context injection, including Claude Code, Cursor, Amp, Codex, and 37 more IDE agents.
</Note>

## Installation

```bash theme={null}
# Install all skills at once
npx skills add BintzGavin/apastra --all --full-depth -y
```

You can also install individual skills by path:

```bash theme={null}
npx skills add BintzGavin/apastra/skills/eval
npx skills add BintzGavin/apastra/skills/baseline
npx skills add BintzGavin/apastra/skills/scaffold
npx skills add BintzGavin/apastra/skills/validate
npx skills add BintzGavin/apastra/skills/setup-ci
npx skills add BintzGavin/apastra/skills/getting-started
```

## Available skills

<CardGroup cols={2}>
  <Card title="apastra-getting-started" icon="rocket" href="/quickstart">
    Project setup and onboarding walkthrough. Start here to create your first prompt spec, dataset, evaluator, and suite.
  </Card>

  <Card title="apastra-eval" icon="play" href="/skills/eval">
    Run prompt evaluations using your IDE agent as the harness. Supports suite mode and quick eval mode.
  </Card>

  <Card title="apastra-baseline" icon="bookmark" href="/skills/baseline">
    Establish and manage known-good baselines. Future evals compare against the baseline to detect regressions.
  </Card>

  <Card title="apastra-scaffold" icon="wrench" href="/skills/scaffold">
    Generate new prompt specs, datasets, evaluators, and suites from templates. All files pass schema validation out of the box.
  </Card>

  <Card title="apastra-validate" icon="check" href="/skills/validate">
    Validate all promptops files against JSON schemas. Catch formatting errors and missing fields before running evaluations.
  </Card>

  <Card title="apastra-setup-ci" icon="github" href="/skills/setup-ci">
    Upgrade from local-first evaluation to automated GitHub Actions CI with PR gating and governed releases.
  </Card>
</CardGroup>

## Skill reference

| Skill                     | Install command                                            | What it does                                        |
| ------------------------- | ---------------------------------------------------------- | --------------------------------------------------- |
| `apastra-getting-started` | `npx skills add BintzGavin/apastra/skills/getting-started` | Project setup and first evaluation walkthrough      |
| `apastra-eval`            | `npx skills add BintzGavin/apastra/skills/eval`            | Run evaluations (suite mode and quick eval mode)    |
| `apastra-baseline`        | `npx skills add BintzGavin/apastra/skills/baseline`        | Establish and roll back known-good baselines        |
| `apastra-scaffold`        | `npx skills add BintzGavin/apastra/skills/scaffold`        | Generate prompt specs, datasets, evaluators, suites |
| `apastra-validate`        | `npx skills add BintzGavin/apastra/skills/validate`        | Validate files against JSON schemas                 |
| `apastra-setup-ci`        | `npx skills add BintzGavin/apastra/skills/setup-ci`        | Install GitHub Actions workflows for PR gating      |

## Supported IDEs

Skills install into any IDE agent that supports SKILL.md-based context injection. This includes Claude Code, Cursor, Amp, Codex, and 37 more environments. The `npx skills` CLI handles placement automatically for each IDE.

## How skills work

When you install a skill, the `npx skills` CLI writes the SKILL.md content into your IDE agent's context directory. From that point on, your agent has the full apastra workflow baked into its knowledge — it knows which files to read, which steps to follow, and which artifacts to produce.

The agent becomes your harness. No external runtime, no Python scripts to install, no CI required to get started.

<Tip>
  Start with `apastra-getting-started` to set up your project structure, then add `apastra-eval` and `apastra-baseline` for your first eval-and-baseline cycle.
</Tip>