Files
boshu2__agentops/docs/SKILL-ROUTER.md
Bo 16d764b5a1 feat: add craft-goal and humanize RPI reports (#988)
## What changed

- add `craft-goal`, a bounded Mayor-style goal compiler/linter for
persistent campaigns over bead-shaped RPI experiments
- add its Codex and Gemini runtime projections plus generated catalogs,
manifests, router, graph, maps, tiers, and registry entries
- split RPI reporting into two explicit surfaces: concise human-readable
interactive output by default, with the full `rpi-report.v1` object
retained as the machine/audit artifact
- add feature and validation assertions that prevent raw schema dumps
from becoming the default interactive response again

## Why

Recent AgentOps history repeatedly showed long-running goal campaigns
confusing the outer goal with one RPI experiment. It also exposed a
presentation bug where the RPI skill instructed agents to paste the
transport-shaped YAML report into chat. This change captures the
corrected goal model and keeps machine evidence separate from the
operator-facing response.

## Validation

- `bash scripts/regen-all.sh --check`
- `bash skills/craft-goal/scripts/validate.sh`
- `bash skills/rpi/scripts/validate.sh`
- `python3 -m unittest skills/rpi/tests/test_run_once.py`
- Codex parity, generated-artifact, and override-coverage checks
- `git diff --check origin/main...HEAD`
- `bash scripts/ci-local-release.sh --fast` ran all branch-relevant
checks successfully; its aggregate exit remained nonzero only for the
pre-existing `skills/using-gc` description-budget violation, which is
unchanged from `origin/main`
2026-07-23 23:24:56 +00:00

5.2 KiB

Skill Router

49 live skills. Metadata is the sole inventory and graph source.

keep

implement, plan, rpi, validate

keep_off_path

learn

keep_strategy

council, idea-genie, postmortem, premortem, reality-check

keep_optional_adapter

agent-mail, agent-native, agy-native, automation-shape-routing, codex-exec, ntm, swarm, using-gc

keep_specialist

account-rotation, bootstrap, cass, cc-hooks, codebase-recon, converter, craft-goal, dcg, doc, domain, goals, handoff, ms, operationalize, pattern-mining, product, rch, refactor, research, reverse-engineer, sbh, scaffold, scope, security, shared, skill-builder, standards, status, test, toil-mining, workflow-builder

Complete inventory

Skill Tier Disposition Hard dependencies Capabilities Effects
account-rotation execution keep_specialist - account_rotation -
agent-mail execution keep_optional_adapter - agent_mail -
agent-native meta keep_optional_adapter - role_dispatch, observe_workers, handoff manage_runtime_sessions
agy-native cross-vendor keep_optional_adapter - dispatch_explicit_packet, provide_fresh_context start_agy_session
automation-shape-routing meta keep_optional_adapter - automation_shape_routing -
bootstrap session keep_specialist - bootstrap -
cass execution keep_specialist - cass -
cc-hooks execution keep_specialist - cc_hooks -
codebase-recon execution keep_specialist - codebase_recon -
codex-exec orchestration keep_optional_adapter - codex_exec -
converter cross-vendor keep_specialist - converter -
council judgment keep_strategy - collect_independent_judgments, synthesize_disagreement write_advisory_council_report
craft-goal judgment keep_specialist - goal_prompt_design, goal_prompt_lint -
dcg execution keep_specialist - dcg -
doc product keep_specialist - doc -
domain knowledge keep_specialist - domain -
goals product keep_specialist - goals -
handoff session keep_specialist - handoff -
idea-genie execution keep_strategy - generate_evidenced_options, dueling_idea_genies write_idea_portfolio
implement execution keep - execute_one_experiment, collect_factual_evidence modify_declared_subject, derive_subject_manifest
learn execution keep_off_path - analyze_verdict_collections write_advisory_observations
ms execution keep_specialist - ms -
ntm execution keep_optional_adapter - ntm -
operationalize meta keep_specialist - distill_expertise, propose_artifact_shape write_advisory_proposal
pattern-mining execution keep_specialist - pattern_mining -
plan execution keep - shape_intent, define_acceptance, bound_write_scope update_intent_source
postmortem judgment keep_strategy - postmortem -
premortem judgment keep_strategy - challenge_plan write_advisory_plan_review
product product keep_specialist - shape_product_boundary write_product_document
rch execution keep_specialist - rch -
reality-check judgment keep_strategy - compare_claim_to_evidence write_advisory_gap_report
refactor execution keep_specialist - refactor -
research execution keep_specialist - research -
reverse-engineer execution keep_specialist - reverse_engineer -
rpi meta keep plan, implement, validate orchestrate_once, report dispatch_core_phases
sbh execution keep_specialist - sbh -
scaffold execution keep_specialist - scaffold -
scope meta keep_specialist - scope_review -
security product keep_specialist - security -
shared library keep_specialist - provide_reference_context -
skill-builder meta keep_specialist - skill_builder, heal_skill writes_skill_source, regenerates_skill_projections, optional_skill_projection_repair
standards knowledge keep_specialist - standards -
status session keep_specialist - status -
swarm execution keep_optional_adapter - dispatch_once invoke_selected_executor
test execution keep_specialist - test -
toil-mining meta keep_specialist - toil_mining -
using-gc execution keep_optional_adapter - dispatch_explicit_packet, observe_gc_runtime, drive_mayor_shepherd operate_gas_city
validate judgment keep - compute_subject_identity, judge_acceptance, persist_verdict write_verdict_artifact
workflow-builder meta keep_specialist - workflow_builder -