Parent PRD

#2

What to build

Create @agentskit/skills — a collection of ready-made skills (prompts + behavioral instructions). Each skill follows the SkillDefinition contract from core.

Ship starter skills: researcher, coder, planner, critic, summarizer. Each contains a systemPrompt, few-shot examples, suggested tools, and best practices.

Implement skill composition: when multiple skills are provided, their systemPrompts concatenate with clear delimiters. Skills can reference other skills via delegates for multi-agent patterns. onActivate hook enables auto-registration of related tools.

Acceptance criteria

• packages/skills/ package created with tsup, vitest
• Each skill satisfies the SkillDefinition contract from core
• Starter skills: researcher, coder, planner, critic, summarizer
• Each skill has: name, description, systemPrompt, examples, suggested tools
• Skill composition: multiple skills' prompts concatenate correctly with delimiters
• delegates field: planner skill references researcher and coder
• onActivate hook: demonstrated on at least one skill (e.g., researcher activates web search)
• Works with useChat({ skills: [...] }) and runtime.run(task, { skill })
• Contract compliance tests for every skill
• Prompt composition unit tests
• Package builds and passes lint

Blocked by

• Blocked by Evolve core contracts & extract shared primitives #3 (core contracts — SkillDefinition)

User stories addressed

• User story 10 (pre-built skills)
• User story 11 (skill delegation via delegates)
• User story 12 (onActivate hooks)