@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:

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:

pnpm add @standardagents/skill

Usage

Read the bundled skill directly from node_modules:

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:

import { copySkill } from '@standardagents/skill'

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

That creates:

.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

pnpm build
pnpm typecheck
pnpm test:run