Plan: Repo-wide Skill Review, Simplification, and Docs Alignment

[graysurf]

Plan: Repo-wide Skill Review, Simplification, and Docs Alignment

Overview

This plan reviews and corrects all repo skills using create-skill governance rules, then simplifies skill entrypoints and scripts with the same method used in PR #221 (release-workflow single-entrypoint refactor).
Work is sequenced as sprint gates (no cross-sprint execution parallelism), with parallelism only inside each sprint.
The implementation target is a final, production-ready skill/doc set: no stale scripts, no outdated guidance, and final-state deliverables that do not include progress-tracking language.

Scope

• In scope:
  • All tracked skills under skills/**/SKILL.md (currently 44 tracked files across automation, tools, workflows).
  • Skill contracts, entrypoints, tests, script specs, fixtures, and linked docs.
  • Repo docs alignment for skill behavior and validation workflow.
• Out of scope:
  • Ignored local skills under skills/.system/ for committed repo deliverables unless explicitly promoted into tracked files.
  • New feature workflows unrelated to skill governance/simplification.
  • Non-skill production code outside docs/scripts/tests impacted by skill entrypoint or docs parity.

Assumptions

1. The canonical skill governance checks remain:
   • skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh
   • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
2. plan-tooling, bash, git, and python3 stay available locally.
3. PR Simplify release-workflow to a single publish entrypoint #221 patterns are treated as the reference simplification approach for entrypoint consolidation and script retirement.
4. Final output wording requirement means user-facing deliverables must describe confirmed final state, not intermediate progress states.

Review + Modification Method (derived from PR #221)

1. Per skill, identify the smallest stable public command surface and keep one primary entrypoint whenever possible.
2. Merge or inline fragmented legacy wrappers into the primary entrypoint flow.
3. Remove obsolete scripts only together with their dependent smoke specs/fixtures/tests.
4. Update SKILL.md contract + usage text + referenced docs in the same change.
5. Update contract tests, entrypoint ownership checks, and smoke tests to match the simplified interface.
6. If script removal is breaking for callers, add explicit migration notes (replacement command, old->new mapping, impact).

Required per-skill decision record:

Field	Requirement
old entrypoint	Current command/script path before remediation
decision	keep | merge | remove
new entrypoint	Final supported command/script path
test/spec updates	Exact tests + script specs changed/removed/added
migration note	Caller-impact statement and old->new mapping

Task Decomposition

Task	Summary	Owner	Branch	Worktree	Execution Mode	PR	Status	Notes
S1T1	Build Complete Skill Inventory	subagent-s1-t1	issue/s1-t1-build-complete-skill-inventory	issue-s1-t1	pr-shared	#223	done	sprint=S1; plan-task:Task 1.1; validate=git ls-files 'skills/**/SKILL.md' / sort; pr-grouping=group; pr-group=s1-auto-g1; shared-pr-anchor=S1T1
S1T2	Freeze create-skill Compliance Checklist	subagent-s1-t1	issue/s1-t1-build-complete-skill-inventory	issue-s1-t1	pr-shared	#223	done	sprint=S1; plan-task:Task 1.2; deps=Task 1.1; validate=skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh; pr-grouping=group; pr-group=s1-auto-g1; shared-pr-anchor=S1T1
S1T3	Freeze PR #221 Simplification Playbook	subagent-s1-t1	issue/s1-t1-build-complete-skill-inventory	issue-s1-t1	pr-shared	#223	done	sprint=S1; plan-task:Task 1.3; deps=Task 1.1; validate=rg -n "release-publish-from-changelog/removed legacy/contract/entrypoint tests/migration" docs/plans/pr-221-reference-notes.md; pr-grouping=group; pr-group=s1-auto-g1; shared-pr-anchor=S1T1
S1T4	Generate Script Remediation Map	subagent-s1-t4	issue/s1-t4-generate-script-remediation-map	issue-s1-t4	pr-isolated	#224	done	sprint=S1; plan-task:Task 1.4; deps=Task 1.2,Task 1.3; validate=bash scripts/ci/stale-skill-scripts-audit.sh --check; pr-grouping=group; pr-group=s1-auto-g2
S2T1	Normalize Workflow Skill Contracts and References	subagent-s2-t1	issue/s2-t1-normalize-workflow-skill-contracts-and-reference	issue-s2-t1	pr-shared	#225	done	sprint=S2; plan-task:Task 2.1; validate=skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh; pr-grouping=group; pr-group=s2-auto-g1; shared-pr-anchor=S2T1
S2T2	Simplify Workflow Scripts Using PR #221 Method	subagent-s2-t1	issue/s2-t1-normalize-workflow-skill-contracts-and-reference	issue-s2-t1	pr-shared	#225	done	sprint=S2; plan-task:Task 2.2; deps=Task 2.1; validate=bash scripts/ci/stale-skill-scripts-audit.sh --check; pr-grouping=group; pr-group=s2-auto-g1; shared-pr-anchor=S2T1
S2T3	Normalize Tools Skill Contracts and References	subagent-s2-t3	issue/s2-t3-normalize-tools-skill-contracts-and-references	issue-s2-t3	pr-shared	#226	done	sprint=S2; plan-task:Task 2.3; validate=skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh; pr-grouping=group; pr-group=s2-auto-g2; shared-pr-anchor=S2T3
S2T4	Simplify Tools Scripts and Clean Companion Specs/Fixtures	subagent-s2-t3	issue/s2-t3-normalize-tools-skill-contracts-and-references	issue-s2-t3	pr-shared	#226	done	sprint=S2; plan-task:Task 2.4; deps=Task 2.3; validate=bash scripts/ci/stale-skill-scripts-audit.sh --check; pr-grouping=group; pr-group=s2-auto-g2; shared-pr-anchor=S2T3
S2T5	Cross-Domain Integration Pass for Workflows + Tools	subagent-s2-t1	issue/s2-t1-normalize-workflow-skill-contracts-and-reference	issue-s2-t1	pr-shared	#225	done	sprint=S2; plan-task:Task 2.5; deps=Task 2.2,Task 2.4; validate=scripts/check.sh --docs; pr-grouping=group; pr-group=s2-auto-g1; shared-pr-anchor=S2T1
S3T1	Normalize Automation Skill Contracts and Coverage	subagent-s3-t1	issue/s3-t1-normalize-automation-skill-contracts-and-coverag	issue-s3-t1	pr-shared	#228	done	sprint=S3; plan-task:Task 3.1; validate=skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh; pr-grouping=group; pr-group=s3-auto-g1; shared-pr-anchor=S3T1
S3T2	Simplify Automation Scripts with Single-Entrypoint Bias	subagent-s3-t1	issue/s3-t1-normalize-automation-skill-contracts-and-coverag	issue-s3-t1	pr-shared	#228	done	sprint=S3; plan-task:Task 3.2; deps=Task 3.1; validate=bash scripts/ci/stale-skill-scripts-audit.sh --check; pr-grouping=group; pr-group=s3-auto-g1; shared-pr-anchor=S3T1
S3T3	Normalize Automation Shared References and Library Boundaries	subagent-s3-t3	issue/s3-t3-normalize-automation-shared-references-and-libra	issue-s3-t3	pr-shared	#227	done	sprint=S3; plan-task:Task 3.3; validate=rg -n "shared primitive/entrypoint/wrapper" skills/automation/README.md skills/automation/_libs/README.md; pr-grouping=group; pr-group=s3-auto-g2; shared-pr-anchor=S3T3
S3T4	Migration Notes + Deprecation Cleanup for Removed Entrypoints	subagent-s3-t3	issue/s3-t3-normalize-automation-shared-references-and-libra	issue-s3-t3	pr-shared	#227	done	sprint=S3; plan-task:Task 3.4; deps=Task 3.2,Task 3.3; validate=scripts/check.sh --docs; pr-grouping=group; pr-group=s3-auto-g2; shared-pr-anchor=S3T3
S4T1	Align Root + Runbook Docs to Final Skill Surface	subagent-s4-t1	issue/s4-t1-align-root-runbook-docs-to-final-skill-surface	issue-s4-t1	per-sprint	#229	done	sprint=S4; plan-task:Task 4.1; validate=scripts/check.sh --docs; pr-grouping=group; pr-group=s4-auto-g1; shared-pr-anchor=S4T1
S4T2	Remove Outdated/Inappropriate Content and Progress-Style Wording	subagent-s4-t1	issue/s4-t1-align-root-runbook-docs-to-final-skill-surface	issue-s4-t1	per-sprint	#229	done	sprint=S4; plan-task:Task 4.2; deps=Task 4.1; validate=scripts/check.sh --docs; pr-grouping=group; pr-group=s4-auto-g1; shared-pr-anchor=S4T1
S4T3	Full Quality Gate + Regression Verification	subagent-s4-t1	issue/s4-t1-align-root-runbook-docs-to-final-skill-surface	issue-s4-t1	per-sprint	#229	done	sprint=S4; plan-task:Task 4.3; deps=Task 4.2; validate=scripts/check.sh --all; pr-grouping=group; pr-group=s4-auto-g1; shared-pr-anchor=S4T1
S4T4	Publish Final Outcome Artifacts (No Progress Ledger)	subagent-s4-t1	issue/s4-t1-align-root-runbook-docs-to-final-skill-surface	issue-s4-t1	per-sprint	#229	done	sprint=S4; plan-task:Task 4.4; deps=Task 4.3; validate=scripts/check.sh --docs; pr-grouping=group; pr-group=s4-auto-g1; shared-pr-anchor=S4T1

Consistency Rules

• Status must be one of: planned, in-progress, blocked, done.
• Status = in-progress or done requires non-TBD execution metadata (Owner, Branch, Worktree, Execution Mode, PR).
• Owner must be a subagent identifier (contains subagent) once the task is assigned; main-agent ownership is invalid for implementation tasks.
• Execution Mode should be one of: per-sprint, pr-isolated, pr-shared (or TBD before assignment).
• Branch and Worktree uniqueness is enforced only for rows using Execution Mode = pr-isolated.

Risks / Uncertainties

• Sprint approvals may be recorded before final close; issue stays open until final plan acceptance.
• Close gate fails if task statuses or PR merge states in the issue body are incomplete.

Evidence

• Plan source: docs/plans/skills-repo-review-simplification-plan.md
• Sprint approvals: issue comments (one comment per accepted sprint)
• Final approval: issue/pull comment URL passed to close-plan

[graysurf]

Sprint 1 Start

• Sprint: 1 (Baseline Audit + Rubric Freeze)
• Tasks in sprint: 4
• Note: Main-agent starts this sprint on the plan issue and dispatches implementation to subagents.
• Execution Mode comes from current Task Decomposition for each sprint task.

Task	Summary	Execution Mode
S1T1	Build Complete Skill Inventory	pr-shared
S1T2	Freeze create-skill Compliance Checklist	pr-shared
S1T3	Freeze PR #221 Simplification Playbook	pr-shared
S1T4	Generate Script Remediation Map	pr-isolated

Sprint 1: Baseline Audit + Rubric Freeze

Goal: produce an execution-ready inventory and review rubric so all later edits are deterministic and complete.
Demo/Validation:

• Command(s):
  • skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh
  • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • plan-tooling split-prs --file docs/plans/skills-repo-review-simplification-plan.md --scope sprint --sprint 1 --pr-grouping group --strategy deterministic --pr-group S1T1=s1-g1 --pr-group S1T2=s1-g2 --pr-group S1T3=s1-g3 --pr-group S1T4=s1-g4 --format json
• Verify: audit artifacts enumerate every skill and every tracked skill script with explicit keep/merge/remove intent.

PR grouping intent: group
Execution Profile: parallel-x2
Deterministic PR split (max PR complexity <= 6):

• s1-g1: Task 1.1

• s1-g2: Task 1.2

• s1-g3: Task 1.3

• s1-g4: Task 1.4
  Sprint scorecard (planned):

• Execution Profile: parallel-x2

• TotalComplexity: 16

• CriticalPathComplexity: 12

• MaxBatchWidth: 2

• OverlapHotspots: docs/plans/* audit artifacts and governance command outputs

Task 1.1: Build Complete Skill Inventory

• Location:
  • skills/README.md
  • skills/tools/skill-management/create-skill/SKILL.md
  • skills/workflows/plan/create-plan-rigorous/SKILL.md
  • skills/automation/release-workflow/SKILL.md
  • tests/script_specs/skills/tools/skill-management/create-skill/scripts/create_skill.sh.json
  • docs/plans/skills-inventory-audit.md
• Description: Generate a canonical inventory for all tracked skills (domain, entrypoints, tests, script specs, dependencies, docs links).
• Dependencies:
  • none
• Complexity: 3
• Acceptance criteria:
  • Inventory covers every tracked skills/**/SKILL.md.
  • Each skill row includes script count and test coverage status.
• Validation:
  • git ls-files 'skills/**/SKILL.md' | sort
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • rg -n \"^\\| skills/.*/SKILL.md \\|\" docs/plans/skills-inventory-audit.md

Task 1.2: Freeze create-skill Compliance Checklist

• Location:
  • skills/tools/skill-management/create-skill/SKILL.md
  • skills/tools/skill-management/skill-governance/SKILL.md
  • docs/runbooks/skills/SKILL_REVIEW_CHECKLIST.md
• Description: Convert create-skill contract rules into a reusable repo-wide review checklist (contract headings/order, allowed layout, required tests, entrypoint references).
• Dependencies:
  • Task 1.1
• Complexity: 4
• Acceptance criteria:
  • Checklist is command-backed (each rule maps to a deterministic check).
  • Checklist can be applied to any existing skill, not only newly scaffolded skills.
• Validation:
  • skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh
  • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
  • scripts/check.sh --entrypoint-ownership

Task 1.3: Freeze PR #221 Simplification Playbook

• Location:
  • skills/automation/release-workflow/SKILL.md
  • docs/plans/pr-221-reference-notes.md
  • docs/runbooks/skills/SCRIPT_SIMPLIFICATION_PLAYBOOK.md
• Description: Encode PR Simplify release-workflow to a single publish entrypoint #221 simplification method into a reusable decision playbook for all skills (single-entrypoint preference, coupled script+test+spec cleanup, migration note policy).
• Dependencies:
  • Task 1.1
• Complexity: 4
• Acceptance criteria:
  • Playbook includes concrete keep/merge/remove decision rules.
  • Playbook includes required post-change validation matrix (contracts/layout/docs/smoke/regression).
• Validation:
  • rg -n \"release-publish-from-changelog|removed legacy|contract/entrypoint tests|migration\" docs/plans/pr-221-reference-notes.md
  • rg -n \"old entrypoint|decision|new entrypoint|test/spec updates|migration note\" docs/runbooks/skills/SCRIPT_SIMPLIFICATION_PLAYBOOK.md
  • scripts/check.sh --markdown

Task 1.4: Generate Script Remediation Map

• Location:
  • docs/plans/skills-script-remediation-map.md
  • docs/plans/skills-coverage-matrix.md
  • scripts/ci/stale-skill-scripts-audit.sh
  • skills/automation/release-workflow/scripts/release-publish-from-changelog.sh
  • tests/script_specs/skills/automation/release-workflow/scripts/release-publish-from-changelog.sh.json
• Description: For every tracked skill script, classify as keep/merge/remove and specify required companion updates (SKILL.md, tests, script specs, fixtures, migration notes).
• Dependencies:
  • Task 1.2
  • Task 1.3
• Complexity: 5
• Acceptance criteria:
  • No skill script remains without explicit decision and rationale.
  • Every remove/merge action has corresponding test/spec/doc update requirements.
  • Skill coverage matrix has 0 unassigned tracked skills.
• Validation:
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • scripts/check.sh --entrypoint-ownership
  • test \"$(git ls-files 'skills/**/SKILL.md' | wc -l | tr -d ' ')\" -eq \"$(tail -n +3 docs/plans/skills-coverage-matrix.md | wc -l | tr -d ' ')\"
  • ! rg -n \"UNASSIGNED\" docs/plans/skills-coverage-matrix.md

[graysurf]

Sprint 1 Ready for Review

• Sprint: 1 (Baseline Audit + Rubric Freeze)
• Tasks in sprint: 4
• Note: Main-agent requests sprint-level review before merge/acceptance on the plan issue (the issue remains open).
• PR values come from current Task Decomposition; unresolved tasks remain TBD until PRs are linked.

Task	Summary	PR
S1T1	Build Complete Skill Inventory	#223
S1T2	Freeze create-skill Compliance Checklist	#223
S1T3	Freeze PR #221 Simplification Playbook	#223
S1T4	Generate Script Remediation Map	#224

[graysurf]

Main-agent review evidence for PR #223: #223 (comment)

[graysurf]

Main-agent review evidence for PR #224: #224 (comment)

[graysurf]

Sprint 1 approved for accept-sprint gate by main-agent review. Merged PRs: #223 #224.

[graysurf]

Sprint 1 Accepted

• Sprint: 1 (Baseline Audit + Rubric Freeze)
• Tasks in sprint: 4
• Note: Main-agent records sprint acceptance after merge gate passes and sprint rows are synced to done (issue remains open for remaining sprints).
• PR values come from current Task Decomposition; unresolved tasks remain TBD until PRs are linked.
• Approval comment URL: Plan: Repo-wide Skill Review, Simplification, and Docs Alignment #222 (comment)

Task	Summary	PR
S1T1	Build Complete Skill Inventory	#223
S1T2	Freeze create-skill Compliance Checklist	#223
S1T3	Freeze PR #221 Simplification Playbook	#223
S1T4	Generate Script Remediation Map	#224

[graysurf]

Sprint 2 Start

• Sprint: 2 (Workflows + Tools Skill Remediation)
• Tasks in sprint: 5
• Note: Main-agent starts this sprint on the plan issue and dispatches implementation to subagents.
• Execution Mode comes from current Task Decomposition for each sprint task.

Task	Summary	Execution Mode
S2T1	Normalize Workflow Skill Contracts and References	pr-shared
S2T2	Simplify Workflow Scripts Using PR #221 Method	pr-shared
S2T3	Normalize Tools Skill Contracts and References	pr-shared
S2T4	Simplify Tools Scripts and Clean Companion Specs/Fixtures	pr-shared
S2T5	Cross-Domain Integration Pass for Workflows + Tools	pr-shared

Sprint 2: Workflows + Tools Skill Remediation

Goal: bring all workflows and tools skills to the frozen checklist and simplification playbook, including script/spec/test/doc consistency.
Demo/Validation:

• Command(s):
  • scripts/check.sh --contracts --skills-layout --entrypoint-ownership
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • scripts/test.sh -m script_smoke
  • plan-tooling split-prs --file docs/plans/skills-repo-review-simplification-plan.md --scope sprint --sprint 2 --pr-grouping group --strategy deterministic --pr-group S2T1=s2-g1 --pr-group S2T2=s2-g2 --pr-group S2T3=s2-g3 --pr-group S2T4=s2-g4 --pr-group S2T5=s2-g5 --format json
• Verify: no contract/layout drift, no removable stale scripts, smoke coverage matches retained entrypoints.

PR grouping intent: group
Execution Profile: parallel-x2
Deterministic PR split (max PR complexity <= 6):

• s2-g1: Task 2.1

• s2-g2: Task 2.2

• s2-g3: Task 2.3

• s2-g4: Task 2.4

• s2-g5: Task 2.5
  Sprint scorecard (planned):

• Execution Profile: parallel-x2

• TotalComplexity: 24

• CriticalPathComplexity: 14

• MaxBatchWidth: 2

• OverlapHotspots: README.md, skills/README.md, tests/script_specs/skills/**

• SizingJustification: TotalComplexity=24 is intentional because two independent domain lanes (workflows/tools) converge only at a final integration task.

Task 2.1: Normalize Workflow Skill Contracts and References

• Location:
  • skills/workflows/plan/create-plan/SKILL.md
  • skills/workflows/plan/create-plan-rigorous/SKILL.md
  • skills/workflows/issue/issue-lifecycle/SKILL.md
  • skills/workflows/pr/feature/create-feature-pr/SKILL.md
  • skills/workflows/pr/feature/create-feature-pr/tests/test_workflows_pr_feature_create_feature_pr.py
• Description: Apply create-skill contract/layout expectations to all workflow skills and sync documented entrypoints with actual files.
• Dependencies:
  • none
• Complexity: 5
• Acceptance criteria:
  • Workflow skill contracts are structurally valid and consistent.
  • SKILL.md entrypoint references match actual maintained scripts.
• Validation:
  • skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh
  • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
  • rg -n \"\\$AGENT_HOME/.*/scripts/\" skills/workflows

Task 2.2: Simplify Workflow Scripts Using PR #221 Method

• Location:
  • skills/workflows/issue/issue-lifecycle/scripts/manage_issue_lifecycle.sh
  • skills/workflows/issue/issue-pr-review/scripts/manage_issue_pr_review.sh
  • tests/script_specs/skills/workflows/issue/issue-lifecycle/scripts/manage_issue_lifecycle.sh.json
  • tests/script_specs/skills/workflows/issue/issue-pr-review/scripts/manage_issue_pr_review.sh.json
  • tests/test_script_smoke_gh_workflows.py
• Description: Consolidate fragmented workflow entrypoints, remove obsolete wrappers/specs/fixtures, and keep only necessary public commands.
• Dependencies:
  • Task 2.1
• Complexity: 5
• Acceptance criteria:
  • Removed scripts have replacement mapping (or explicit keep rationale).
  • Smoke specs and tests exactly match retained workflow entrypoints.
• Validation:
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • scripts/test.sh -m script_smoke
  • rg -n \"manage_issue_(lifecycle|pr_review)\\.sh\" tests/script_specs/skills/workflows/issue

Task 2.3: Normalize Tools Skill Contracts and References

• Location:
  • skills/tools/agent-doc-init/SKILL.md
  • skills/tools/browser/playwright/SKILL.md
  • skills/tools/skill-management/create-skill/SKILL.md
  • skills/tools/testing/api-test-runner/SKILL.md
  • skills/tools/skill-management/create-skill/tests/test_tools_skill_management_create_skill.py
• Description: Apply the same contract/layout and reference normalization to all tool skills.
• Dependencies:
  • none
• Complexity: 5
• Acceptance criteria:
  • Tool skill contracts and layouts pass governance checks.
  • Tool docs reference only current and supported entrypoints.
• Validation:
  • skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh
  • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
  • rg -n \"\\$AGENT_HOME/.*/scripts/\" skills/tools

Task 2.4: Simplify Tools Scripts and Clean Companion Specs/Fixtures

• Location:
  • skills/tools/devex/desktop-notify/scripts/desktop-notify.sh
  • skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh
  • tests/script_specs/skills/tools/devex/desktop-notify/scripts/desktop-notify.sh.json
  • tests/script_specs/skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh.json
  • tests/fixtures/api-test-runner/fixture.suite.json
• Description: Apply PR Simplify release-workflow to a single publish entrypoint #221 simplification pattern to tools scripts and remove obsolete companion specs/fixtures while keeping coverage for retained entrypoints.
• Dependencies:
  • Task 2.3
• Complexity: 5
• Acceptance criteria:
  • Entry-point simplification does not leave orphan specs/fixtures.
  • Any breaking command rename/remove has migration notes.
• Validation:
  • bash scripts/ci/stale-skill-scripts-audit.sh --check
  • scripts/check.sh --entrypoint-ownership
  • scripts/test.sh -m script_smoke
  • rg -n \"desktop-notify.sh|audit-skill-layout.sh\" tests/script_specs/skills/tools

Task 2.5: Cross-Domain Integration Pass for Workflows + Tools

• Location:
  • README.md
  • skills/README.md
  • DEVELOPMENT.md
  • docs/testing/script-smoke.md
  • docs/testing/script-regression.md
• Description: Align cross-domain docs and validation commands with the updated workflows/tools skill surface.
• Dependencies:
  • Task 2.2
  • Task 2.4
• Complexity: 4
• Acceptance criteria:
  • Catalog/docs mention only valid current entrypoints.
  • Docs/testing instructions align with actual checks and scripts.
• Validation:
  • scripts/check.sh --docs
  • scripts/check.sh --markdown
  • rg -n \"scripts/check.sh --all|scripts/ci/stale-skill-scripts-audit.sh --check\" README.md DEVELOPMENT.md docs/testing/script-smoke.md

[graysurf]

Sprint 2 Ready for Review

• Sprint: 2 (Workflows + Tools Skill Remediation)
• Tasks in sprint: 5
• Note: Main-agent requests sprint-level review before merge/acceptance on the plan issue (the issue remains open).
• PR values come from current Task Decomposition; unresolved tasks remain TBD until PRs are linked.

Task	Summary	PR
S2T1	Normalize Workflow Skill Contracts and References	#225
S2T2	Simplify Workflow Scripts Using PR #221 Method	#225
S2T3	Normalize Tools Skill Contracts and References	#226
S2T4	Simplify Tools Scripts and Clean Companion Specs/Fixtures	#226
S2T5	Cross-Domain Integration Pass for Workflows + Tools	#225

[graysurf]

Main-agent review evidence for PR #225: #225 (comment)