Docs · xscriptor-ai

Quick start

zsh

$ npx @xscriptor/ai-agents✓ 181 specialized agents · 24 senior agents✓ 21 skills · 8 commands→ ~/.config/opencode/

Installs 205 agents, 21 skills, and 8 commands into ~/.config/opencode/. Target another platform or scope with the flags below.

Flag	Effect
`--agents`	Specialized agents only
`--senior`	Senior agents only
`--skills`	Project and senior skills only
`--commands`	Slash commands only
`--groups LIST`	Specific groups, e.g. `general,web/security`
`--anthropic`	Install the Claude Code mirror into `~/.claude/`
`--project`	Install into `.opencode/` in the current directory
`--dry-run`	Preview without copying
`--list`	List available groups and counts

Install script

The bash installer detects sibling checkouts of the agents and skills repos, or downloads them automatically. Requires curl and tar (or git).

zsh

$ curl -fsSL https://raw.githubusercontent.com/xscriptor-ai/scripts/main/install-agents.sh | bash

Or from a local clone:

clone + install

$ git clone https://github.com/xscriptor-ai/scripts.git
git clone https://github.com/xscriptor-ai/agents.git
git clone https://github.com/xscriptor-ai/skills.git
cd scripts && ./install-agents.sh

The script accepts the same selection flags as the npm package plus --interactive and --global. Environment overrides: XSCRIPTOR_AGENTS_DIR, XSCRIPTOR_SKILLS_DIR, XSCRIPTOR_REF.

What gets installed

Content	Count	OpenCode destination
Specialized agents	181	`~/.config/opencode/agents/`
Senior agents	24	`~/.config/opencode/agents/`
Skills	21	`~/.config/opencode/skills/`
Commands	8	`~/.config/opencode/commands/`

With --project, everything goes to .opencode/ in the current directory instead, which keeps installs isolated per repository.

Claude Code

Claude Code uses a different frontmatter schema, so the collection ships a generated mirror with translated agents, prefixed skills (senior-python), and x- commands to avoid collisions with native ones.

zsh

$ npx @xscriptor/ai-agents --anthropic

This installs ~/.claude/agents/xscriptor/, ~/.claude/skills/{name}, and ~/.claude/commands/x-*.md. To uninstall, remove ~/.claude/agents/xscriptor and the skill folders you installed.

Packages

Package	Command
`@xscriptor/ai-agents`	`npx @xscriptor/ai-agents`
`@xscriptor/skill-xscriptor`	`npx @xscriptor/skill-xscriptor`
`@xscriptor/skill-devx`	`npx @xscriptor/skill-devx`
`@xscriptor/skill-samurai`	`npx @xscriptor/skill-samurai`

Utilities

The scripts repo ships maintenance tools. They auto-detect a sibling agents checkout, or accept --agents PATH.

validate-agents.sh — check frontmatter, fields, temperature, and permissions.
check-permissions.sh — audit permission risk across the collection.
agent-stats.sh / agent-stats.py — counts, temperature, color, and permission distribution.
diff-agents.sh — compare installed agents against the repo.
build-docs.sh — generate a combined reference document.
generate-agent.sh — interactive generator for new agents.
backup-agents.sh — timestamped backup of installed agents.

Updating

Re-run the installer to refresh an installation. For OpenCode, use diff-agents.sh to see what changed before overwriting, and scope installs with --project if you want per-repository control.

Sources: agents and skills are generated from the repositories, this site included. Last sync 2026-09-14.