observal-agents
Create, update, version, and manage Observal agents. Use when the user wants to create a new agent, update an existing one, release a new version, scaffold a YAML project, add components, build, publish, bulk-create, archive, delete, or restore agents.
npx skills add Observal/Observal --skill observal-agents --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Observal Agents: Agent Lifecycle Management ## Critical Rules 1. **EXECUTE commands**: run them in your shell. Set timeout to 60 seconds. 2. **Use single quotes** for `--prompt` and `--description` values. 3. **Pass `--output json`** on list/show/versions commands. 4. **Pass `--yes`** on destructive commands (`archive`, `delete`, `unarchive`, `bulk-create`). 5. **Resolve 409:** `observal agent publish --update` for in-place edits, `observal agent release --bump` for reviewed releases. 6. **When in doubt about a flag, run `<command> --help` first.** --- ## Procedure: Create Agent Required: `--name`, `--description`, `--prompt`. Optional: `--model`, `--harness` (repeatable), `--prompt-file`, `--from-file`. Before choosing a model, query the registry for every selected harness and pick an available exact model: ```bash observal registry models --harness kiro --output plain observal registry models --harness claude-code --output plain ``` > **WARNING:** Without `--name` and `--prompt`, the command launches an interactive wizard. Always pass at least `--name`, `--description`, and `--prompt`. ```bash observal agent create \ --name AGENT_NAME \ --description 'Short description' \ --pro
- Critical Rules
- Procedure: Create Agent
- Procedure: Update Agent
- Procedure: Release Agent Version
- Procedure: Author Agent Locally
- Procedure: Bulk Create
- Procedure: Archive / Restore
- Browse Agents
- Procedure: Manage Co-Authors
- Error Reference
- Output Contract
observal registry models --harness kiro --output plain observal registry models --harness claude-code --output plain observal agent create \ mkdir -p /tmp/myagent && cat > /tmp/myagent/observal-agent.yaml << 'EOF' observal agent release AGENT_NAME --bump patch --dir /tmp/myagent observal registry mcp list --search 'github docker' --output json observal registry skill list --search 'frontend design' --output json observal registry skill list --team platform-tools --output json observal agent add mcp COMPONENT_UUID --dir ./my-agent observal agent add skill COMPONENT_UUID --dir ./my-agent
What does the observal-agents skill do?
Create, update, version, and manage Observal agents. Use when the user wants to create a new agent, update an existing one, release a new version, scaffold a YAML project, add components, build, publish, bulk-create, archive, delete, or restore agents.
How do I install it?
Run `npx skills add Observal/Observal --skill observal-agents --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Observal/Observal, a repository with 2,254 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.