Skip to main content
skill CX Codex

setup · wrg32786 — Claude Code skill: what it does, how to install

This Claude Code skill configures aigent-OS identity, priorities, and authority boundaries. Run /setup to configure the system or revise specific sections later.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill setup -a claude-code
Open on GitHub

What setup does

The skill guides aigent-OS configuration section by section: role and collaboration style, current priorities, AI authority, decision rules, projects, and people. It can also define specialist agents and store their details for registration in .claude/agents/.

It reads installation state from .aigent/state.json. If the status is not ready, it routes to /start unless advanced setup was explicitly requested; for a ready installation, it asks which section to revise. Completed sections are saved as the interview proceeds, and unrelated user content is preserved. A failed required write prevents the installation from being marked ready.

When configuration is complete, the skill logs the changes, updates state, and creates .aigent/first-run-done. Installing it with the npm command requires npx.

What it helps with

  • record the operator’s role and collaboration preferences
  • set active priorities and urgent outcomes
  • define which AI actions need human approval
  • update project and people notes
  • write a specialist agent definition

Example prompts for the agent

  • /setup revise AI authority boundaries and spending approvals
  • /setup update my current priorities and urgent outcome
  • /setup add a project and define a specialist agent

How to install setup

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill setup -a claude-code

2Manually: put the files in place

~/.claude/skills/setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about setup

How do I install setup in Claude Code?

Run npx skills add wrg32786/aigent-os --skill setup -a claude-code. The skill file is available at ~/.claude/skills/setup/SKILL.md.

What does setup do?

It configures aigent-OS identity, priorities, AI authority, decision rules, projects, and people. It can also save definitions for specialist agents.

How is setup different from start?

/start handles the initial onboarding flow. /setup provides deeper configuration and can revise individual sections later.

Source text

SKILL.md · MIT
---
name: setup
description: "Configure aigent-OS identity, priorities, authority, projects, people, and decision logic. Use when running setup, reconfiguring settings, or changing authority levels."
trigger: /setup
---

# aigent-OS setup and reconfiguration

`/start` owns the day-one onboarding arc. `/setup` is the deeper configuration flow and may also be used later to revise one section.

## Entry behavior

Read `.aigent/state.json` first.

- If state is missing or not `ready`, route through `/start` unless the operator explicitly requested advanced setup.
- If state is `ready`, ask which configuration area needs revision rather than replaying the entire interview.
- Never detect setup state by searching for placeholder prose in a Markdown file.

Before writing, set `status: setup-in-progress` while preserving any prior `completedAt`. On interruption, the next `/start` or `/setup` should resume from the last durably completed section.

## Interview

Ask one question at a time and write each completed section immediately.

### 1. Identity

Ask for the operator's role, responsibilities, preferred collaboration style, and risk posture. Update `system/00_identity.md` without replacing framework-owned doctrine.

### 2. Priorities

Ask for the top two or three active priorities, the most urgent outcome, operating mode, and blockers. Update `vault/memory/ACTIVE_PRIORITIES.md`.

### 3. Authority boundaries

Ask what the AI may handle autonomously, what needs confirmation, what is human-only, and whether spending has an escalation threshold. Update `system/12_authority_matrix.md`.

### 4. Decision logic

Ask what makes the operator accept or reject opportunities, their active-work limit, and their most common time trap. Update `system/14_decision_framework.md`.

### 5. Projects and people

For each active project, capture purpose, current state, priority, next action, and relevant people. Create or update notes under `vault/projects/` and `vault/people/`, then connect them from active priorities with wikilinks.

### 6. Specialist agents

Ask whether any specialized agents are useful now. For each accepted agent, capture name, scope, tools, model tier, escalation boundary, and success criteria. Store the definition in `vault/agents/` with valid `name:` and `tools:` frontmatter so the installer can register it in `.claude/agents/`.

## Completion

After all requested sections are durably written:

1. Summarize exactly what changed.
2. Append an idempotent setup entry to `vault/memory/SESSION_LOG.md`.
3. Set `.aigent/state.json` to:

```json
{
  "schemaVersion": 1,
  "status": "ready",
  "completedAt": "<ISO-8601 timestamp>"
}
```

4. Write `.aigent/first-run-done` for compatibility with older installs.
5. Teach or remind the operator of `/open`, normal work, and `/close`.

Do not mark the installation ready when required writes failed.

## Rules

- One section at a time.
- Adapt to information already supplied.
- Mirror the operator's language without inventing details.
- Preserve user-authored content and make precise edits.
- Sections may be deferred explicitly.
- Reconfiguration must not erase unrelated state.

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

SKILL.md skills catalog →

setup by other authors comes first.

setup official anthropics setup is a Claude Code skill that checks connected tools, learns your writing style from sent email, and builds a starter dashboard without a questionnaire. For first run. CX Codex +1 371installs setup Alireza Rezvani setup sets up an autoresearch experiment by collecting its target file, evaluation command, metric, and optimization direction. Use it before starting an optimization loop. CX Codex +1 1,480installs setup aws This skill kicks off the connection setup for AWS DevOps Agent and AWS Security Agent. Reach for it when MCP tools go missing or you are wiring the toolkit up for the first time. CX Codex +1 1,600installs setup marketcalls setup sets up a Python backtesting environment with VectorBT and OpenAlgo. It configures the virtual environment, installs dependencies, and prepares .env. CX Codex +1 2,100installs setup assistant-ui setup is a Claude Code skill that installs and configures assistant-ui through its CLI. It covers new projects, existing Next.js apps, and package updates. CX Codex +1 6,400installs setup-matt-pocock-skills Matt Pocock The setup-matt-pocock-skills skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. CX Codex +1 1,052,851installs setup-pre-commit Matt Pocock The setup-pre-commit skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. CX Codex +1 489,289installs prisma-database-setup prisma prisma-database-setup is a deprecated compatibility name for the prisma-orm-setup skill, which handles Prisma setup and database connection repair. CX Codex +1 439,300installs prisma-postgres-setup prisma prisma-postgres-setup provisions or connects a Prisma Postgres database and links it to your app. Useful for spinning up dev databases quickly or wiring connections in Vercel and v0. CX Codex +1 425,700installs xcode-project-setup Google LLC xcode-project-setup is a Claude Code skill that adds Swift Packages and links modules in .pbxproj via a native Swift script. It activates for iOS dependency installation requests. CX Codex +1 141,900installs caveman-setup JuliusBrussee caveman-setup routes LLM API calls through the Caveman Cloud gateway to measure token costs without altering app behavior. Useful for tracking model spend across a repo. CX Codex +1 127,300installs

From the same set58

The whole set →
skill-recall This Claude Code skill matches a task with local skills. Run /skill-recall to find candidates or record a gap when none fit. CX Codex +1 ★ 26repo stars skill-hunt The skill-hunt Claude Code skill finds skills that fill a capability gap. It ranks candidates, checks a selected skill, then installs it in quarantine. CX Codex +1 ★ 26repo stars Skill Audit The Skill Audit Claude Code skill checks skill usage and whether descriptions match the prompts that trigger them. It also flags idle skills and recurring work with no matching skill. CX Codex +1 ★ 26repo stars ship-adapter The ship-adapter Claude Code skill turns schemas and API contracts into adapters. It runs for database adapters, API client wrappers, interface adapters, and data transformers. CX Codex +1 ★ 26repo stars semantic-search The semantic-search Claude Code skill searches an Obsidian vault by meaning using local embeddings. It runs for finding related notes or recalling what you wrote about a topic. CX Codex +1 ★ 26repo stars Self-Review The Self-Review Claude Code skill sends substantial code changes through a focused second review. It targets multi-file edits, hot paths, prompts, and work that still feels uncertain. CX Codex +1 ★ 26repo stars scout-vault The scout-vault Claude Code skill finds related vault notes, links, and code definitions. It runs for note discovery, vault inventory, or call-chain searches. CX Codex +1 ★ 26repo stars Sandbox Routing Sandbox Routing — a skill for Claude Code routes large-file analysis and lengthy command output through sandbox tools. It activates when an agent needs a small detail without pulling the full output into context. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open