- Installs
- 839
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/boshu2/agentops --skill quickstart- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads quickstart automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
/quickstart
One job: Tell a new user what AgentOps does and what to do first. Fast.
YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.
Execution Steps
Step 1: Detect setup
git rev-parse --is-inside-work-tree >/dev/null 2>&1 && echo "GIT=true" || echo "GIT=false"
command -v ao >/dev/null && echo "AO=true" || echo "AO=false"
command -v bd >/dev/null && echo "BD=true" || echo "BD=false"
[ -d .agents ] && echo "AGENTS=true" || echo "AGENTS=false"
[ -d "$HOME/.agents" ] && echo "GLOBAL_AGENTS=true" || echo "GLOBAL_AGENTS=false"
[ -n "${CODEX_THREAD_ID:-}" ] || [ "${CODEX_INTERNAL_ORIGINATOR_OVERRIDE:-}" = "Codex Desktop" ] && echo "CODEX=true" || echo "CODEX=false"
Step 2: Show what AgentOps does
Output exactly this (no additions, no diagrams):
AgentOps is the operational layer for coding agents.
It gives your coding agent four things it doesn't have by default:
Bookkeeping — sessions capture learnings, findings, and reusable context in .agents/
Validation — /council, /pre-mortem, and /vibe challenge plans and code before shipping
Primitives — skills, execution packets, and the ao CLI give you building blocks for almost any interaction
Flows — /research, /implement, /validate, and /rpi can run alone or compose end to end
Key skills: /rpi /research /validate /implement /council /pre-mortem /swarm /status
Fresh-session orientation: `ao session bootstrap`, then `ao inject` / `ao corpus inject --query "<topic>"`
Full reference: /quickstart --catalog
Step 3: One next action
Match the first row that applies. Output that message.
| Condition | Message |
|---|---|
| GIT=false + AO=true + GLOBAL_AGENTS=true | "🗂 You're outside a git repo but have a global corpus at ~/.agents. Global knowledge workflow:\n 1. /curate --mode=harvest — scan all .agents/ across your repos and promote artifacts into ~/.agents/learnings/\n 2. /compile — mine, synthesize, and write an interlinked wiki into .agents/compiled/ (runs from cwd; set AGENTOPS_COMPILE_RUNTIME=claude-cli if you have the claude CLI, no API key needed)\n 3. /inject — turn the compiled corpus into playbooks, a belief book, and runtime briefings for future sessions\n 4. /status — flywheel health snapshot\nIf instead you want to start a fresh repo-local project here, git init first." |
| GIT=false | "⚠ Not in a git repo. Run git init first.\n (If you meant to work against your global ~/.agents corpus, run /quickstart from a dir with .agents/ or see /curate --mode=harvest, /compile, /inject.)" |
| AO=false + CODEX=true | "📦 Install ao CLI first:\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\nThen: /rpi \"a small goal\" to run your first cycle.\nUse /bootstrap after the core seed when you want PRODUCT.md, README.md, and PROGRAM.md." |
| AO=false | "📦 Install ao CLI first:\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\nThen: /rpi \"a small goal\" to run your first cycle.\nUse /bootstrap after the core seed when you want PRODUCT.md, README.md, and PROGRAM.md." |
| AGENTS=false + CODEX=true | "🌱 ao is installed but not initialized here.\n Run ao quick-start to apply the repeatable core seed. ao quickstart is the stable alias.\n Then run /bootstrap only if you want the product/operations layer: PRODUCT.md, README.md, PROGRAM.md/AUTODEV.md, and optional hooks.\nThen: /rpi \"a small goal\" to run your first cycle." |
| AGENTS=false | "🌱 ao is installed but not initialized here.\n Run ao quick-start to apply the repeatable core seed. ao quickstart is the stable alias.\n Then run /bootstrap only if you want the product/operations layer: PRODUCT.md, README.md, PROGRAM.md/AUTODEV.md, and optional hooks.\nThen: /rpi \"a small goal\" to run your first cycle." |
| BD=false + CODEX=true | "✅ Codex plugin path ready.\n /rpi \"your goal\" — full /discovery → /crank → /validate pipeline\n /research <topic> — explore the codebase\n Default installs are hookless; native hooks are optional with install-codex.sh --with-hooks.\n Legacy explicit fallback commands remain ao codex ensure-start / ao codex ensure-stop when needed.\n Manual escape hatch: ao codex status\n Want issue tracking? brew install boshu2/agentops/beads && bd init --prefix <prefix>" |
| BD=false | "✅ Flywheel active. Start now:\n /rpi \"your goal\" — full /discovery → /crank → /validate pipeline\n /validate — close out recent work and capture learnings\n /research <topic> — explore the codebase\n Want issue tracking? brew install boshu2/agentops/beads && bd init --prefix <prefix>" |
| BD=true + CODEX=true | "✅ Codex full stack ready.\n ao reconcile --json — check git, CI, release, beads, and .agents agree\n bd ready — see open work after high-severity reconciliation findings are clear\n /rpi \"your goal\" — start a new goal from scratch\n Default installs are hookless; native hooks are optional with install-codex.sh --with-hooks.\n Legacy explicit fallback commands remain ao codex ensure-start / ao codex ensure-stop when needed.\n Manual escape hatch: ao codex status" |
| BD=true | "✅ Full stack ready.\n ao reconcile --json — check git, CI, release, beads, and .agents agree\n bd ready — see open work after high-severity reconciliation findings are clear\n /rpi \"your goal\" — start a new goal from scratch\n /status — see current session state" |
Starting a new project? Run /scaffold <language> <name> to generate project structure with best practices.
Examples
First-Time Setup
User says: /quickstart
What happens: Agent detects tools, shows one-line status, gives the single next action to run.
Already Set Up
User says: /quickstart
What happens: Agent detects full stack is ready and suggests ao reconcile --json, bd ready, or /rpi "your goal".
Troubleshooting
| Problem | Solution |
|---|---|
| Skills not installed | bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh) |
| Hook activation | AgentOps 3.0 is hookless — there is no ao command or flag that installs hooks, and CI is the authoritative gate. Hooks are opt-in and author-it-yourself via the hooks-authoring skill. |
| Flywheel count is 0 | First session — run /rpi "a small goal" to start it |
| Want the full skill catalog | Ask: "show me all the skills" or see references/full-catalog.md |
Reference Documents
-
references/quickstart.feature — Executable spec: detect setup (git/ao/bd/.agents), recommend a state-appropriate next action (soc-qk4b)
-
references/getting-started.md
-
references/troubleshooting.md
-
references/full-catalog.md
See Also
- scaffold — Project scaffolding and component generation
FAQ
What does the quickstart skill do?
Show AgentOps next action.
How do I install quickstart?
Run npx skills add https://github.com/boshu2/agentops --skill quickstart in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/quickstart/ (personal) or .claude/skills/quickstart/ (project).
Which AI agents can use quickstart?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is quickstart safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains quickstart?
It is published by boshu2 in boshu2/agentops. It has 839 recorded installs.
More from boshu2/agentops
council
boshu2/agentops
Compare independent opinions from several models or contexts without inflating agreement. Use when: wanting a second opinion or debate, or summarizing several reviewers' results.
doc
boshu2/agentops
Write source-checked docs, READMEs, change descriptions and handoffs. Use when: documenting a change, leaving or resuming a handoff, or drafting a questionnaire for someone else.
research
boshu2/agentops
Answer one cited question on code, history, claims or patterns. Use when: asked how it works, why it changed, if a claim or done/shipped report holds, or a pattern warrants a rule.
plan
boshu2/agentops
Shape a request into one end-to-end slice with observable behavior; review write scope and reversible decisions. Use when: planning, breaking down or scoping a change.
swarm
boshu2/agentops
Dispatch explicit disjoint packets exactly once through a caller-selected executor. Triggers: "swarm", "dispatch disjoint packets", "parallel explicit tasks".
rpi
boshu2/agentops
Drive one accepted change through implementation and checks to done, with one fresh review only where a mistake is costly. Use when: asked to run or orchestrate work through RPI.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.