# @standardagents/skill

Markdown-authored coding skills for Standard Agents and AgentBuilder.

## Overview

`@standardagents/skill` ships reusable skill folders that help coding agents
compose and build Standard Agents projects effectively. The skill content lives
in plain `.md` files so you can inspect, copy, and edit it without touching a
build step.

The first bundled skill is:

- `agentbuilder` - guidance for composing models, prompts, tools, hooks, APIs,
  and subagents in Standard Agents projects

## Installation

Recommended:

```bash
npx @standardagents/cli skill
```

This opens an interactive picker and installs the bundled `agentbuilder`
guidance into a supported coding agent. Currently:

- Codex gets a skill folder in `$CODEX_HOME/skills` or `~/.codex/skills`
- Claude Code gets a user subagent in `~/.claude/agents/agentbuilder.md`

Package install:

```bash
pnpm add @standardagents/skill
```

## Usage

Read the bundled skill directly from `node_modules`:

```ts
import { listSkills, readSkillFile, resolveSkillDir } from '@standardagents/skill'

console.log(listSkills())
console.log(resolveSkillDir('agentbuilder'))

const skillMarkdown = await readSkillFile('agentbuilder')
console.log(skillMarkdown)
```

Copy the editable markdown skill into a local skills directory:

```ts
import { copySkill } from '@standardagents/skill'

await copySkill('agentbuilder', '.codex/skills', { overwrite: true })
```

That creates:

```text
.codex/skills/
  agentbuilder/
    SKILL.md
```

## Files

- `skills/agentbuilder/SKILL.md` - entrypoint skill file
- `src/index.ts` - helper API for locating, reading, and copying skills

## Development

```bash
pnpm build
pnpm typecheck
pnpm test:run
```