For the complete documentation index optimized for AI agents, see llms.txt or llms-full.txt. A markdown version of this page is available by appending.mdto the URL or sendingAccept: text/markdown.
Skills Reference
For AI agents: the documentation index is at llms.txt (full corpus: llms-full.txt). A markdown source for this page is /agent-skills/setup.md.
Reference for installing Arete agent skills manually. For an overview of how skills, the CLI, and agent.md fit together, see Agent Skills.
The universal install command (auto-detects your editor):
npx skills add AreteA4/skillsPer-Editor Installation
Section titled “Per-Editor Installation”npx skills add AreteA4/skills --agent cursorFiles are created in .agents/skills/:
.agents/skills/├── arete/SKILL.md├── arete-consume/SKILL.md└── arete-build/SKILL.mdnpx skills add AreteA4/skills --agent claude-codeFiles are created in .claude/skills/:
.claude/skills/├── arete/SKILL.md├── arete-consume/SKILL.md└── arete-build/SKILL.mdYou can also set project-level context in CLAUDE.md at the project root.
npx skills add AreteA4/skills --agent windsurfFiles are created in .windsurf/skills/:
.windsurf/skills/├── arete/SKILL.md├── arete-consume/SKILL.md└── arete-build/SKILL.mdnpx skills add AreteA4/skills --agent opencodeFiles are created in .agents/skills/. You can also load skills directly using the /skill command in OpenCode.
npx skills add AreteA4/skills --agent github-copilotFiles are created in .agents/skills/.
npx skills add AreteA4/skills --agent clineFiles are created in .cline/skills/.
npx skills supports 35+ agents:
| Agent | Flag |
|---|---|
| Codex | --agent codex |
| Gemini CLI | --agent gemini-cli |
| Roo Code | --agent roo |
| Goose | --agent goose |
| Continue | --agent continue |
If your editor isn’t listed, manually copy the SKILL.md files from the skills repository into whatever directory your editor reads custom context from.
Verifying Installation
Section titled “Verifying Installation”Ask your agent:
What stacks are available on Arete? Show me the entities and fields for the ore stack.
The agent should run a4 explore --json, then a4 explore ore --json, and present the entity names, field paths, and types. If it doesn’t recognise Arete commands, check that the skill files are in the correct directory for your editor.
Updating Skills
Section titled “Updating Skills”npx skills add AreteA4/skillsThis overwrites existing skill files with the latest versions. The static patterns (SDK syntax, DSL macros) change rarely — dynamic data (entity schemas, field types) always comes from a4 explore at runtime, so it’s always current regardless of skill version.