From d5eae3837384f31544deb19c14efc1f39b7e386d Mon Sep 17 00:00:00 2001 From: Boden Fuller Date: Wed, 16 Sep 2026 10:53:48 -0400 Subject: [PATCH 1/2] docs: curate current skills on skills.sh --- CHANGELOG.md | 6 ++++++ docs/CHANGELOG.md | 6 ++++++ skills.sh.json | 31 +++++++++++++++++++++++++++++++ 3 files changed, 43 insertions(+) create mode 100644 skills.sh.json diff --git a/CHANGELOG.md b/CHANGELOG.md index 40a7fbad5..02c872365 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +### Added + +- Curated skills.sh groups put Research, Test, and Refactor first, followed by + the rest of the current 34-skill catalog. Ungrouped historical entries remain + below the current skills; this changes discovery, not installation behavior. + ## [3.7.0] - 2026-09-13 AgentOps 3.7 makes native coding the default: accepted intent, implementation diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 40a7fbad5..02c872365 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +### Added + +- Curated skills.sh groups put Research, Test, and Refactor first, followed by + the rest of the current 34-skill catalog. Ungrouped historical entries remain + below the current skills; this changes discovery, not installation behavior. + ## [3.7.0] - 2026-09-13 AgentOps 3.7 makes native coding the default: accepted intent, implementation diff --git a/skills.sh.json b/skills.sh.json new file mode 100644 index 000000000..c631e2567 --- /dev/null +++ b/skills.sh.json @@ -0,0 +1,31 @@ +{ + "$schema": "https://skills.sh/schemas/skills.sh.schema.json", + "notGrouped": "bottom", + "groupings": [ + { + "title": "Start here", + "description": "Trace a behavior, cover a regression, or simplify code. Use one skill for the task in front of you; no new workflow or ao CLI is required.", + "skills": ["research", "test", "refactor"] + }, + { + "title": "Build and review", + "description": "Clarify a change, implement it, and check the result. Choose these independently; Validate requires the ao CLI.", + "skills": ["plan", "implement", "validate", "doc", "domain", "security", "reality-check"] + }, + { + "title": "Explore and learn", + "description": "Compare ideas and retrieve relevant context when it can help the current task.", + "skills": ["idea-genie", "reverse-engineer", "memory", "cass", "ms"] + }, + { + "title": "Deliberate workflows", + "description": "Select a review strategy, the RPI charter, goal planning, or skill authoring and evaluation when the task calls for it.", + "skills": ["premortem", "council", "postmortem", "rpi", "craft-goal", "skill-builder", "skill-eval"] + }, + { + "title": "Optional tool adapters", + "description": "Use these only with the corresponding runtime or tool. They are not prerequisites for the starter skills.", + "skills": ["agent-native", "codex-exec", "agy-native", "ntm", "agent-mail", "using-gc", "using-flywheel", "cc-hooks", "dcg", "rch", "sbh", "account-rotation"] + } + ] +} From 0101ae2964c251139768442e97512123e9f49af5 Mon Sep 17 00:00:00 2001 From: Boden Fuller Date: Wed, 16 Sep 2026 11:00:40 -0400 Subject: [PATCH 2/2] docs: repair published skill and setup links --- CHANGELOG.md | 5 ++ docs/CHANGELOG.md | 5 ++ docs/SKILL-ROUTER.md | 68 ++++++++++++------------ docs/SKILLS.md | 68 ++++++++++++------------ docs/_hooks/gen_skill_pages.py | 4 +- docs/agent-workflow-reference.md | 2 +- docs/releases/2026-09-13-v3.7.0-notes.md | 2 +- scripts/generate-skill-mesh.py | 2 +- 8 files changed, 83 insertions(+), 73 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 02c872365..d492437a5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 the rest of the current 34-skill catalog. Ungrouped historical entries remain below the current skills; this changes discovery, not installation behavior. +### Fixed + +- Skill catalog, schema, and setup links resolve to their repository sources + from the published documentation site, restoring its strict build check. + ## [3.7.0] - 2026-09-13 AgentOps 3.7 makes native coding the default: accepted intent, implementation diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 02c872365..d492437a5 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -13,6 +13,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 the rest of the current 34-skill catalog. Ungrouped historical entries remain below the current skills; this changes discovery, not installation behavior. +### Fixed + +- Skill catalog, schema, and setup links resolve to their repository sources + from the published documentation site, restoring its strict build check. + ## [3.7.0] - 2026-09-13 AgentOps 3.7 makes native coding the default: accepted intent, implementation diff --git a/docs/SKILL-ROUTER.md b/docs/SKILL-ROUTER.md index 722087fca..07272e56d 100644 --- a/docs/SKILL-ROUTER.md +++ b/docs/SKILL-ROUTER.md @@ -10,60 +10,60 @@ Names and descriptions below come from each source SKILL.md; explicit invocation | Skill | Use it for | |---|---| -| [implement](../skills/implement/SKILL.md) | Implement accepted behavior, repair defects or execute a selected wave with per-lane evidence. Use when: coding is authorized and ready; return facts, not a binding verdict. | -| [plan](../skills/plan/SKILL.md) | Define intended behavior, review write scope and assess reversible decisions. Use when: acceptance or approach is unclear before coding; stop once actionable. | -| [validate](../skills/validate/SKILL.md) | Freshly judge a finished change against original acceptance before merge. Use when: independent proof is needed; author tests cannot issue PASS. Triggers: "check this change". | +| [implement](https://github.com/boshu2/agentops/blob/main/skills/implement/SKILL.md) | Implement accepted behavior, repair defects or execute a selected wave with per-lane evidence. Use when: coding is authorized and ready; return facts, not a binding verdict. | +| [plan](https://github.com/boshu2/agentops/blob/main/skills/plan/SKILL.md) | Define intended behavior, review write scope and assess reversible decisions. Use when: acceptance or approach is unclear before coding; stop once actionable. | +| [validate](https://github.com/boshu2/agentops/blob/main/skills/validate/SKILL.md) | Freshly judge a finished change against original acceptance before merge. Use when: independent proof is needed; author tests cannot issue PASS. Triggers: "check this change". | ## Engineering specialists | Skill | Use it for | |---|---| -| [doc](../skills/doc/SKILL.md) | Write grounded docs, READMEs, repo instructions or continuity handoffs. Use when: these documents are requested; no reports as a routine completion ritual. | -| [domain](../skills/domain/SKILL.md) | Clarify domain terms, bounded contexts and repository conventions. Use when: naming, rule ownership or Go and other language standards are unclear; avoid a broad survey. | -| [refactor](../skills/refactor/SKILL.md) | Simplify structure, interfaces or responsibilities while preserving behavior. Use when: a focused refactor is requested; feature changes need their own intent. | -| [research](../skills/research/SKILL.md) | Trace code or test a recurring pattern to answer one cited question. Use when: uncertainty needs evidence. Not for external feature teardowns; use reverse-engineer. | -| [reverse-engineer](../skills/reverse-engineer/SKILL.md) | Tear down an authorized competitor repo, binary or product into a feature inventory and adoption choices. Use when: comparing an external system; local questions go to Research. | -| [security](../skills/security/SKILL.md) | Review code or scan for security vulnerabilities, secrets, dependencies and prompt risks. Use when: concrete exposure needs assessment; never silently change policy. | -| [skill-builder](../skills/skill-builder/SKILL.md) | Create, adapt, consolidate or repair skill packages and projections. Use when: authoring guidance, descriptions or structure; Skill Eval measures behavioral benefit. | -| [skill-eval](../skills/skill-eval/SKILL.md) | Measure whether a skill helps a named task or needs revision or removal. Use when: a bounded routing or coding evaluation is requested; conformance alone cannot show benefit. | -| [test](../skills/test/SKILL.md) | Write behavioral tests, practice TDD or inspect important coverage gaps. Use when: test design or missing proof needs work; running an existing suite needs no skill. | +| [doc](https://github.com/boshu2/agentops/blob/main/skills/doc/SKILL.md) | Write grounded docs, READMEs, repo instructions or continuity handoffs. Use when: these documents are requested; no reports as a routine completion ritual. | +| [domain](https://github.com/boshu2/agentops/blob/main/skills/domain/SKILL.md) | Clarify domain terms, bounded contexts and repository conventions. Use when: naming, rule ownership or Go and other language standards are unclear; avoid a broad survey. | +| [refactor](https://github.com/boshu2/agentops/blob/main/skills/refactor/SKILL.md) | Simplify structure, interfaces or responsibilities while preserving behavior. Use when: a focused refactor is requested; feature changes need their own intent. | +| [research](https://github.com/boshu2/agentops/blob/main/skills/research/SKILL.md) | Trace code or test a recurring pattern to answer one cited question. Use when: uncertainty needs evidence. Not for external feature teardowns; use reverse-engineer. | +| [reverse-engineer](https://github.com/boshu2/agentops/blob/main/skills/reverse-engineer/SKILL.md) | Tear down an authorized competitor repo, binary or product into a feature inventory and adoption choices. Use when: comparing an external system; local questions go to Research. | +| [security](https://github.com/boshu2/agentops/blob/main/skills/security/SKILL.md) | Review code or scan for security vulnerabilities, secrets, dependencies and prompt risks. Use when: concrete exposure needs assessment; never silently change policy. | +| [skill-builder](https://github.com/boshu2/agentops/blob/main/skills/skill-builder/SKILL.md) | Create, adapt, consolidate or repair skill packages and projections. Use when: authoring guidance, descriptions or structure; Skill Eval measures behavioral benefit. | +| [skill-eval](https://github.com/boshu2/agentops/blob/main/skills/skill-eval/SKILL.md) | Measure whether a skill helps a named task or needs revision or removal. Use when: a bounded routing or coding evaluation is requested; conformance alone cannot show benefit. | +| [test](https://github.com/boshu2/agentops/blob/main/skills/test/SKILL.md) | Write behavioral tests, practice TDD or inspect important coverage gaps. Use when: test design or missing proof needs work; running an existing suite needs no skill. | ## Memory on demand | Skill | Use it for | |---|---| -| [memory](../skills/memory/SKILL.md) | Recall reviewed lessons or deliberately mine and curate experience. Use when: prior evidence can change an action, or learning is requested; no mandatory recall or lesson. | +| [memory](https://github.com/boshu2/agentops/blob/main/skills/memory/SKILL.md) | Recall reviewed lessons or deliberately mine and curate experience. Use when: prior evidence can change an action, or learning is requested; no mandatory recall or lesson. | ## Deliberate planning and review strategies | Skill | Use it for | |---|---| -| [council](../skills/council/SKILL.md) | Compare independent views on a consequential or contested decision. Use when: the caller selects multiple judges; evidence resolves disagreement, not voting. | -| [craft-goal](../skills/craft-goal/SKILL.md) | Draft or lint a bounded persistent goal above a bead graph of RPI experiments. Use when: this goal workflow is explicitly selected; shaping a single change belongs to Plan. | -| [idea-genie](../skills/idea-genie/SKILL.md) | Generate evidenced options or challenge an idea. Use when: deciding what to build or comparing alternatives; exploration does not authorize implementation. | -| [postmortem](../skills/postmortem/SKILL.md) | Analyze outcomes or an interim cutoff. Use when: a postmortem is explicitly requested; consumes available judgment, never gates code acceptance or requires a lesson. | -| [premortem](../skills/premortem/SKILL.md) | Challenge a rollout plan with one fresh judge before implementation; identify what could make it fail. Not for finished-code judgment. Triggers: "one judge", "challenge this plan". | -| [reality-check](../skills/reality-check/SKILL.md) | Check whether a claimed shipped feature, repo state or goal status holds up in evidence. Use when: comparing a claim with what exists; a gap report is not a verdict. | -| [rpi](../skills/rpi/SKILL.md) | Apply the outcome-to-judgment charter. Use when: the caller explicitly selects RPI; ordinary coding, delegation and native goals do not require this workflow. | +| [council](https://github.com/boshu2/agentops/blob/main/skills/council/SKILL.md) | Compare independent views on a consequential or contested decision. Use when: the caller selects multiple judges; evidence resolves disagreement, not voting. | +| [craft-goal](https://github.com/boshu2/agentops/blob/main/skills/craft-goal/SKILL.md) | Draft or lint a bounded persistent goal above a bead graph of RPI experiments. Use when: this goal workflow is explicitly selected; shaping a single change belongs to Plan. | +| [idea-genie](https://github.com/boshu2/agentops/blob/main/skills/idea-genie/SKILL.md) | Generate evidenced options or challenge an idea. Use when: deciding what to build or comparing alternatives; exploration does not authorize implementation. | +| [postmortem](https://github.com/boshu2/agentops/blob/main/skills/postmortem/SKILL.md) | Analyze outcomes or an interim cutoff. Use when: a postmortem is explicitly requested; consumes available judgment, never gates code acceptance or requires a lesson. | +| [premortem](https://github.com/boshu2/agentops/blob/main/skills/premortem/SKILL.md) | Challenge a rollout plan with one fresh judge before implementation; identify what could make it fail. Not for finished-code judgment. Triggers: "one judge", "challenge this plan". | +| [reality-check](https://github.com/boshu2/agentops/blob/main/skills/reality-check/SKILL.md) | Check whether a claimed shipped feature, repo state or goal status holds up in evidence. Use when: comparing a claim with what exists; a gap report is not a verdict. | +| [rpi](https://github.com/boshu2/agentops/blob/main/skills/rpi/SKILL.md) | Apply the outcome-to-judgment charter. Use when: the caller explicitly selects RPI; ordinary coding, delegation and native goals do not require this workflow. | ## Explicit tool and runtime adapters | Skill | Use it for | |---|---| -| [account-rotation](../skills/account-rotation/SKILL.md) | Switch coding-agent accounts and verify runtime identity. Use when: the caller requests an account change; never rotate automatically to evade a quota. | -| [agent-mail](../skills/agent-mail/SKILL.md) | Coordinate selected writers with Agent Mail messages and advisory file reservations. Use when: this adapter is requested; mail does not own tracker status. | -| [agent-native](../skills/agent-native/SKILL.md) | Dispatch independent tasks to parallel workers or selected persistent roles. Use when: delegation is authorized with disjoint scopes; execution does not validate output. | -| [agy-native](../skills/agy-native/SKILL.md) | Run a supplied task in AGY Antigravity and collect its result. Use when: the caller selects AGY; never a fallback for native coding. | -| [cass](../skills/cass/SKILL.md) | Search agent session logs and cited episodes with CASS. Use when: past prompts, decisions or failures may answer a question; repeated text is not a proven lesson. | -| [cc-hooks](../skills/cc-hooks/SKILL.md) | Configure Claude Code hooks and narrow enforcement guards. Use when: the caller requests hook installation, repair or policy changes; a hook is not required to use other skills. | -| [codex-exec](../skills/codex-exec/SKILL.md) | Run one prompt through headless Codex and capture its result. Use when: requesting a single noninteractive Codex process. Not for worker batches or retries. | -| [dcg](../skills/dcg/SKILL.md) | Diagnose a Destructive Command Guard block or configure its rules. Use when: DCG rejected an operation or policy work is requested; never disguise commands to bypass it. | -| [ms](../skills/ms/SKILL.md) | Find and load guidance with the meta_skill search engine. Use when: searching a skill corpus; CASS owns past sessions and Skill Builder owns package authoring. | -| [ntm](../skills/ntm/SKILL.md) | Operate selected NTM agent panes and inspect native state. Use when: persistent tmux roles are requested; pane liveness and prompt delivery are not validation. | -| [rch](../skills/rch/SKILL.md) | Offload one build through RCH or diagnose its remote compiler. Use when: remote compilation is selected; report errors without creating a retry controller. | -| [sbh](../skills/sbh/SKILL.md) | Inspect disk pressure with SBH and perform an authorized recovery action. Use when: storage diagnosis or SBH recovery is requested; inspection does not authorize deletion. | -| [using-flywheel](../skills/using-flywheel/SKILL.md) | Operate the Agentic Coding Flywheel through its native workflow. Use when: the caller explicitly selects this factory; convergence and closed work do not prove semantic acceptance. | -| [using-gc](../skills/using-gc/SKILL.md) | Operate Gas City through its Mayor, registry packs and native run state. Use when: the caller explicitly selects Gas City; factory completion does not replace independent judgment. | +| [account-rotation](https://github.com/boshu2/agentops/blob/main/skills/account-rotation/SKILL.md) | Switch coding-agent accounts and verify runtime identity. Use when: the caller requests an account change; never rotate automatically to evade a quota. | +| [agent-mail](https://github.com/boshu2/agentops/blob/main/skills/agent-mail/SKILL.md) | Coordinate selected writers with Agent Mail messages and advisory file reservations. Use when: this adapter is requested; mail does not own tracker status. | +| [agent-native](https://github.com/boshu2/agentops/blob/main/skills/agent-native/SKILL.md) | Dispatch independent tasks to parallel workers or selected persistent roles. Use when: delegation is authorized with disjoint scopes; execution does not validate output. | +| [agy-native](https://github.com/boshu2/agentops/blob/main/skills/agy-native/SKILL.md) | Run a supplied task in AGY Antigravity and collect its result. Use when: the caller selects AGY; never a fallback for native coding. | +| [cass](https://github.com/boshu2/agentops/blob/main/skills/cass/SKILL.md) | Search agent session logs and cited episodes with CASS. Use when: past prompts, decisions or failures may answer a question; repeated text is not a proven lesson. | +| [cc-hooks](https://github.com/boshu2/agentops/blob/main/skills/cc-hooks/SKILL.md) | Configure Claude Code hooks and narrow enforcement guards. Use when: the caller requests hook installation, repair or policy changes; a hook is not required to use other skills. | +| [codex-exec](https://github.com/boshu2/agentops/blob/main/skills/codex-exec/SKILL.md) | Run one prompt through headless Codex and capture its result. Use when: requesting a single noninteractive Codex process. Not for worker batches or retries. | +| [dcg](https://github.com/boshu2/agentops/blob/main/skills/dcg/SKILL.md) | Diagnose a Destructive Command Guard block or configure its rules. Use when: DCG rejected an operation or policy work is requested; never disguise commands to bypass it. | +| [ms](https://github.com/boshu2/agentops/blob/main/skills/ms/SKILL.md) | Find and load guidance with the meta_skill search engine. Use when: searching a skill corpus; CASS owns past sessions and Skill Builder owns package authoring. | +| [ntm](https://github.com/boshu2/agentops/blob/main/skills/ntm/SKILL.md) | Operate selected NTM agent panes and inspect native state. Use when: persistent tmux roles are requested; pane liveness and prompt delivery are not validation. | +| [rch](https://github.com/boshu2/agentops/blob/main/skills/rch/SKILL.md) | Offload one build through RCH or diagnose its remote compiler. Use when: remote compilation is selected; report errors without creating a retry controller. | +| [sbh](https://github.com/boshu2/agentops/blob/main/skills/sbh/SKILL.md) | Inspect disk pressure with SBH and perform an authorized recovery action. Use when: storage diagnosis or SBH recovery is requested; inspection does not authorize deletion. | +| [using-flywheel](https://github.com/boshu2/agentops/blob/main/skills/using-flywheel/SKILL.md) | Operate the Agentic Coding Flywheel through its native workflow. Use when: the caller explicitly selects this factory; convergence and closed work do not prove semantic acceptance. | +| [using-gc](https://github.com/boshu2/agentops/blob/main/skills/using-gc/SKILL.md) | Operate Gas City through its Mayor, registry packs and native run state. Use when: the caller explicitly selects Gas City; factory completion does not replace independent judgment. | ## Complete inventory diff --git a/docs/SKILLS.md b/docs/SKILLS.md index 722087fca..07272e56d 100644 --- a/docs/SKILLS.md +++ b/docs/SKILLS.md @@ -10,60 +10,60 @@ Names and descriptions below come from each source SKILL.md; explicit invocation | Skill | Use it for | |---|---| -| [implement](../skills/implement/SKILL.md) | Implement accepted behavior, repair defects or execute a selected wave with per-lane evidence. Use when: coding is authorized and ready; return facts, not a binding verdict. | -| [plan](../skills/plan/SKILL.md) | Define intended behavior, review write scope and assess reversible decisions. Use when: acceptance or approach is unclear before coding; stop once actionable. | -| [validate](../skills/validate/SKILL.md) | Freshly judge a finished change against original acceptance before merge. Use when: independent proof is needed; author tests cannot issue PASS. Triggers: "check this change". | +| [implement](https://github.com/boshu2/agentops/blob/main/skills/implement/SKILL.md) | Implement accepted behavior, repair defects or execute a selected wave with per-lane evidence. Use when: coding is authorized and ready; return facts, not a binding verdict. | +| [plan](https://github.com/boshu2/agentops/blob/main/skills/plan/SKILL.md) | Define intended behavior, review write scope and assess reversible decisions. Use when: acceptance or approach is unclear before coding; stop once actionable. | +| [validate](https://github.com/boshu2/agentops/blob/main/skills/validate/SKILL.md) | Freshly judge a finished change against original acceptance before merge. Use when: independent proof is needed; author tests cannot issue PASS. Triggers: "check this change". | ## Engineering specialists | Skill | Use it for | |---|---| -| [doc](../skills/doc/SKILL.md) | Write grounded docs, READMEs, repo instructions or continuity handoffs. Use when: these documents are requested; no reports as a routine completion ritual. | -| [domain](../skills/domain/SKILL.md) | Clarify domain terms, bounded contexts and repository conventions. Use when: naming, rule ownership or Go and other language standards are unclear; avoid a broad survey. | -| [refactor](../skills/refactor/SKILL.md) | Simplify structure, interfaces or responsibilities while preserving behavior. Use when: a focused refactor is requested; feature changes need their own intent. | -| [research](../skills/research/SKILL.md) | Trace code or test a recurring pattern to answer one cited question. Use when: uncertainty needs evidence. Not for external feature teardowns; use reverse-engineer. | -| [reverse-engineer](../skills/reverse-engineer/SKILL.md) | Tear down an authorized competitor repo, binary or product into a feature inventory and adoption choices. Use when: comparing an external system; local questions go to Research. | -| [security](../skills/security/SKILL.md) | Review code or scan for security vulnerabilities, secrets, dependencies and prompt risks. Use when: concrete exposure needs assessment; never silently change policy. | -| [skill-builder](../skills/skill-builder/SKILL.md) | Create, adapt, consolidate or repair skill packages and projections. Use when: authoring guidance, descriptions or structure; Skill Eval measures behavioral benefit. | -| [skill-eval](../skills/skill-eval/SKILL.md) | Measure whether a skill helps a named task or needs revision or removal. Use when: a bounded routing or coding evaluation is requested; conformance alone cannot show benefit. | -| [test](../skills/test/SKILL.md) | Write behavioral tests, practice TDD or inspect important coverage gaps. Use when: test design or missing proof needs work; running an existing suite needs no skill. | +| [doc](https://github.com/boshu2/agentops/blob/main/skills/doc/SKILL.md) | Write grounded docs, READMEs, repo instructions or continuity handoffs. Use when: these documents are requested; no reports as a routine completion ritual. | +| [domain](https://github.com/boshu2/agentops/blob/main/skills/domain/SKILL.md) | Clarify domain terms, bounded contexts and repository conventions. Use when: naming, rule ownership or Go and other language standards are unclear; avoid a broad survey. | +| [refactor](https://github.com/boshu2/agentops/blob/main/skills/refactor/SKILL.md) | Simplify structure, interfaces or responsibilities while preserving behavior. Use when: a focused refactor is requested; feature changes need their own intent. | +| [research](https://github.com/boshu2/agentops/blob/main/skills/research/SKILL.md) | Trace code or test a recurring pattern to answer one cited question. Use when: uncertainty needs evidence. Not for external feature teardowns; use reverse-engineer. | +| [reverse-engineer](https://github.com/boshu2/agentops/blob/main/skills/reverse-engineer/SKILL.md) | Tear down an authorized competitor repo, binary or product into a feature inventory and adoption choices. Use when: comparing an external system; local questions go to Research. | +| [security](https://github.com/boshu2/agentops/blob/main/skills/security/SKILL.md) | Review code or scan for security vulnerabilities, secrets, dependencies and prompt risks. Use when: concrete exposure needs assessment; never silently change policy. | +| [skill-builder](https://github.com/boshu2/agentops/blob/main/skills/skill-builder/SKILL.md) | Create, adapt, consolidate or repair skill packages and projections. Use when: authoring guidance, descriptions or structure; Skill Eval measures behavioral benefit. | +| [skill-eval](https://github.com/boshu2/agentops/blob/main/skills/skill-eval/SKILL.md) | Measure whether a skill helps a named task or needs revision or removal. Use when: a bounded routing or coding evaluation is requested; conformance alone cannot show benefit. | +| [test](https://github.com/boshu2/agentops/blob/main/skills/test/SKILL.md) | Write behavioral tests, practice TDD or inspect important coverage gaps. Use when: test design or missing proof needs work; running an existing suite needs no skill. | ## Memory on demand | Skill | Use it for | |---|---| -| [memory](../skills/memory/SKILL.md) | Recall reviewed lessons or deliberately mine and curate experience. Use when: prior evidence can change an action, or learning is requested; no mandatory recall or lesson. | +| [memory](https://github.com/boshu2/agentops/blob/main/skills/memory/SKILL.md) | Recall reviewed lessons or deliberately mine and curate experience. Use when: prior evidence can change an action, or learning is requested; no mandatory recall or lesson. | ## Deliberate planning and review strategies | Skill | Use it for | |---|---| -| [council](../skills/council/SKILL.md) | Compare independent views on a consequential or contested decision. Use when: the caller selects multiple judges; evidence resolves disagreement, not voting. | -| [craft-goal](../skills/craft-goal/SKILL.md) | Draft or lint a bounded persistent goal above a bead graph of RPI experiments. Use when: this goal workflow is explicitly selected; shaping a single change belongs to Plan. | -| [idea-genie](../skills/idea-genie/SKILL.md) | Generate evidenced options or challenge an idea. Use when: deciding what to build or comparing alternatives; exploration does not authorize implementation. | -| [postmortem](../skills/postmortem/SKILL.md) | Analyze outcomes or an interim cutoff. Use when: a postmortem is explicitly requested; consumes available judgment, never gates code acceptance or requires a lesson. | -| [premortem](../skills/premortem/SKILL.md) | Challenge a rollout plan with one fresh judge before implementation; identify what could make it fail. Not for finished-code judgment. Triggers: "one judge", "challenge this plan". | -| [reality-check](../skills/reality-check/SKILL.md) | Check whether a claimed shipped feature, repo state or goal status holds up in evidence. Use when: comparing a claim with what exists; a gap report is not a verdict. | -| [rpi](../skills/rpi/SKILL.md) | Apply the outcome-to-judgment charter. Use when: the caller explicitly selects RPI; ordinary coding, delegation and native goals do not require this workflow. | +| [council](https://github.com/boshu2/agentops/blob/main/skills/council/SKILL.md) | Compare independent views on a consequential or contested decision. Use when: the caller selects multiple judges; evidence resolves disagreement, not voting. | +| [craft-goal](https://github.com/boshu2/agentops/blob/main/skills/craft-goal/SKILL.md) | Draft or lint a bounded persistent goal above a bead graph of RPI experiments. Use when: this goal workflow is explicitly selected; shaping a single change belongs to Plan. | +| [idea-genie](https://github.com/boshu2/agentops/blob/main/skills/idea-genie/SKILL.md) | Generate evidenced options or challenge an idea. Use when: deciding what to build or comparing alternatives; exploration does not authorize implementation. | +| [postmortem](https://github.com/boshu2/agentops/blob/main/skills/postmortem/SKILL.md) | Analyze outcomes or an interim cutoff. Use when: a postmortem is explicitly requested; consumes available judgment, never gates code acceptance or requires a lesson. | +| [premortem](https://github.com/boshu2/agentops/blob/main/skills/premortem/SKILL.md) | Challenge a rollout plan with one fresh judge before implementation; identify what could make it fail. Not for finished-code judgment. Triggers: "one judge", "challenge this plan". | +| [reality-check](https://github.com/boshu2/agentops/blob/main/skills/reality-check/SKILL.md) | Check whether a claimed shipped feature, repo state or goal status holds up in evidence. Use when: comparing a claim with what exists; a gap report is not a verdict. | +| [rpi](https://github.com/boshu2/agentops/blob/main/skills/rpi/SKILL.md) | Apply the outcome-to-judgment charter. Use when: the caller explicitly selects RPI; ordinary coding, delegation and native goals do not require this workflow. | ## Explicit tool and runtime adapters | Skill | Use it for | |---|---| -| [account-rotation](../skills/account-rotation/SKILL.md) | Switch coding-agent accounts and verify runtime identity. Use when: the caller requests an account change; never rotate automatically to evade a quota. | -| [agent-mail](../skills/agent-mail/SKILL.md) | Coordinate selected writers with Agent Mail messages and advisory file reservations. Use when: this adapter is requested; mail does not own tracker status. | -| [agent-native](../skills/agent-native/SKILL.md) | Dispatch independent tasks to parallel workers or selected persistent roles. Use when: delegation is authorized with disjoint scopes; execution does not validate output. | -| [agy-native](../skills/agy-native/SKILL.md) | Run a supplied task in AGY Antigravity and collect its result. Use when: the caller selects AGY; never a fallback for native coding. | -| [cass](../skills/cass/SKILL.md) | Search agent session logs and cited episodes with CASS. Use when: past prompts, decisions or failures may answer a question; repeated text is not a proven lesson. | -| [cc-hooks](../skills/cc-hooks/SKILL.md) | Configure Claude Code hooks and narrow enforcement guards. Use when: the caller requests hook installation, repair or policy changes; a hook is not required to use other skills. | -| [codex-exec](../skills/codex-exec/SKILL.md) | Run one prompt through headless Codex and capture its result. Use when: requesting a single noninteractive Codex process. Not for worker batches or retries. | -| [dcg](../skills/dcg/SKILL.md) | Diagnose a Destructive Command Guard block or configure its rules. Use when: DCG rejected an operation or policy work is requested; never disguise commands to bypass it. | -| [ms](../skills/ms/SKILL.md) | Find and load guidance with the meta_skill search engine. Use when: searching a skill corpus; CASS owns past sessions and Skill Builder owns package authoring. | -| [ntm](../skills/ntm/SKILL.md) | Operate selected NTM agent panes and inspect native state. Use when: persistent tmux roles are requested; pane liveness and prompt delivery are not validation. | -| [rch](../skills/rch/SKILL.md) | Offload one build through RCH or diagnose its remote compiler. Use when: remote compilation is selected; report errors without creating a retry controller. | -| [sbh](../skills/sbh/SKILL.md) | Inspect disk pressure with SBH and perform an authorized recovery action. Use when: storage diagnosis or SBH recovery is requested; inspection does not authorize deletion. | -| [using-flywheel](../skills/using-flywheel/SKILL.md) | Operate the Agentic Coding Flywheel through its native workflow. Use when: the caller explicitly selects this factory; convergence and closed work do not prove semantic acceptance. | -| [using-gc](../skills/using-gc/SKILL.md) | Operate Gas City through its Mayor, registry packs and native run state. Use when: the caller explicitly selects Gas City; factory completion does not replace independent judgment. | +| [account-rotation](https://github.com/boshu2/agentops/blob/main/skills/account-rotation/SKILL.md) | Switch coding-agent accounts and verify runtime identity. Use when: the caller requests an account change; never rotate automatically to evade a quota. | +| [agent-mail](https://github.com/boshu2/agentops/blob/main/skills/agent-mail/SKILL.md) | Coordinate selected writers with Agent Mail messages and advisory file reservations. Use when: this adapter is requested; mail does not own tracker status. | +| [agent-native](https://github.com/boshu2/agentops/blob/main/skills/agent-native/SKILL.md) | Dispatch independent tasks to parallel workers or selected persistent roles. Use when: delegation is authorized with disjoint scopes; execution does not validate output. | +| [agy-native](https://github.com/boshu2/agentops/blob/main/skills/agy-native/SKILL.md) | Run a supplied task in AGY Antigravity and collect its result. Use when: the caller selects AGY; never a fallback for native coding. | +| [cass](https://github.com/boshu2/agentops/blob/main/skills/cass/SKILL.md) | Search agent session logs and cited episodes with CASS. Use when: past prompts, decisions or failures may answer a question; repeated text is not a proven lesson. | +| [cc-hooks](https://github.com/boshu2/agentops/blob/main/skills/cc-hooks/SKILL.md) | Configure Claude Code hooks and narrow enforcement guards. Use when: the caller requests hook installation, repair or policy changes; a hook is not required to use other skills. | +| [codex-exec](https://github.com/boshu2/agentops/blob/main/skills/codex-exec/SKILL.md) | Run one prompt through headless Codex and capture its result. Use when: requesting a single noninteractive Codex process. Not for worker batches or retries. | +| [dcg](https://github.com/boshu2/agentops/blob/main/skills/dcg/SKILL.md) | Diagnose a Destructive Command Guard block or configure its rules. Use when: DCG rejected an operation or policy work is requested; never disguise commands to bypass it. | +| [ms](https://github.com/boshu2/agentops/blob/main/skills/ms/SKILL.md) | Find and load guidance with the meta_skill search engine. Use when: searching a skill corpus; CASS owns past sessions and Skill Builder owns package authoring. | +| [ntm](https://github.com/boshu2/agentops/blob/main/skills/ntm/SKILL.md) | Operate selected NTM agent panes and inspect native state. Use when: persistent tmux roles are requested; pane liveness and prompt delivery are not validation. | +| [rch](https://github.com/boshu2/agentops/blob/main/skills/rch/SKILL.md) | Offload one build through RCH or diagnose its remote compiler. Use when: remote compilation is selected; report errors without creating a retry controller. | +| [sbh](https://github.com/boshu2/agentops/blob/main/skills/sbh/SKILL.md) | Inspect disk pressure with SBH and perform an authorized recovery action. Use when: storage diagnosis or SBH recovery is requested; inspection does not authorize deletion. | +| [using-flywheel](https://github.com/boshu2/agentops/blob/main/skills/using-flywheel/SKILL.md) | Operate the Agentic Coding Flywheel through its native workflow. Use when: the caller explicitly selects this factory; convergence and closed work do not prove semantic acceptance. | +| [using-gc](https://github.com/boshu2/agentops/blob/main/skills/using-gc/SKILL.md) | Operate Gas City through its Mayor, registry packs and native run state. Use when: the caller explicitly selects Gas City; factory completion does not replace independent judgment. | ## Complete inventory diff --git a/docs/_hooks/gen_skill_pages.py b/docs/_hooks/gen_skill_pages.py index 2c38754b6..852bbc89f 100644 --- a/docs/_hooks/gen_skill_pages.py +++ b/docs/_hooks/gen_skill_pages.py @@ -121,9 +121,9 @@ def emit_detail(skill: dict[str, str]) -> None: lambda m: f"(https://github.com/boshu2/agentops/blob/main/skills/{skill['slug']}/references/{m.group(1)})", body, ) - # Rewrite other same-skill relative paths (e.g., scripts/, templates/) the same way. + # Rewrite other same-skill relative paths (e.g., scripts/, schemas/) the same way. body = re.sub( - r"\((scripts|templates|fixtures|examples)/([^)]+)\)", + r"\((scripts|templates|fixtures|examples|schemas)/([^)]+)\)", lambda m: f"(https://github.com/boshu2/agentops/blob/main/skills/{skill['slug']}/{m.group(1)}/{m.group(2)})", body, ) diff --git a/docs/agent-workflow-reference.md b/docs/agent-workflow-reference.md index 3190a1c5f..2ec253697 100644 --- a/docs/agent-workflow-reference.md +++ b/docs/agent-workflow-reference.md @@ -33,7 +33,7 @@ No new scheduler, command or process ledger is needed. The grandfathered pure fixed-dispatch adapter is separately described in its own reference. Optional context-budget tooling (an opt-in read-budget hook plus bulk-read / code-write delegation) is described in -[context-budget delegation](../skills/agent-native/references/context-budget-delegation.md). +[context-budget delegation](https://github.com/boshu2/agentops/blob/main/skills/agent-native/references/context-budget-delegation.md). For exact intent snapshots, subject manifests, evidence storage, scope and freshness, use [RPI traversal](architecture/rpi-traversal.md) and diff --git a/docs/releases/2026-09-13-v3.7.0-notes.md b/docs/releases/2026-09-13-v3.7.0-notes.md index 7e49c29e2..06bec9df5 100644 --- a/docs/releases/2026-09-13-v3.7.0-notes.md +++ b/docs/releases/2026-09-13-v3.7.0-notes.md @@ -19,7 +19,7 @@ migration guidance below is part of the upgrade. - Replace `ao eval` and `ao redact` automation before updating the binary. Use your repository's evaluator and the owner's disclosure-review process. Generic `ao provenance` can retain factual evidence but does not run either retired service. - Replace `workflows/rpi.js` calls with native execution or an explicitly selected RPI skill invocation. The scripted retry machinery has been removed. Trackers, Git, scheduling and delivery remain under their existing owners. - Update managed plugins through their runtime. For source links, update the canonical checkout, inspect retired names, and relink the surviving skills you selected. `ao skills link --skill NAME` can be repeated; without selectors it links the full menu. It does not remove foreign entries or uninstall previously selected skills. -- Codex role resources ship in the skill bundle, but installing the plugin alone does not register them. From a checkout, run `bash scripts/install-codex-context-agents.sh` for personal configuration or add `--project`, then restart Codex. See [Codex installation](../../.codex/INSTALL.md) for prerequisites and separate hook setup. +- Codex role resources ship in the skill bundle, but installing the plugin alone does not register them. From a checkout, run `bash scripts/install-codex-context-agents.sh` for personal configuration or add `--project`, then restart Codex. See [Codex installation](https://github.com/boshu2/agentops/blob/main/.codex/INSTALL.md) for prerequisites and separate hook setup. - Read-budget guards remain disabled until explicitly installed. The Claude and Codex installers preserve existing settings and backups. Codex hook definitions still need review/trust in its native hook manager; linked-worktree hook installation has documented restrictions. - Preserve existing `.agents/` evidence. New CDLC proof uses a caller-selected protected external non-Git destination. A missing route is a failure, not permission to fall back to repository storage. `ao init` remains an optional local setup command and is not required for native work. - Builds use the Go 1.27.1 toolchain; `cli/go.mod` retains a Go 1.26.0 language floor. Older installations download the selected toolchain or fail according to `GOTOOLCHAIN`. CI and maintained Python checks use Python 3.14. diff --git a/scripts/generate-skill-mesh.py b/scripts/generate-skill-mesh.py index 535055465..2b7bcd391 100755 --- a/scripts/generate-skill-mesh.py +++ b/scripts/generate-skill-mesh.py @@ -167,7 +167,7 @@ def router(entries: list[dict[str, Any]]) -> str: lines += [f"## {heading}", "", "| Skill | Use it for |", "|---|---|"] for entry in members: description = entry["description"].replace("|", "\\|").replace("\n", " ") - lines.append(f"| [{entry['name']}](../skills/{entry['name']}/SKILL.md) | {description} |") + lines.append(f"| [{entry['name']}](https://github.com/boshu2/agentops/blob/main/skills/{entry['name']}/SKILL.md) | {description} |") lines.append("") lines += ["## Complete inventory", "", md_table(entries), ""] return "\n".join(lines)