mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

chore(v2.8.0-sprint3): cross-platform sync + docs generation + MkDocs nav + CHANGELOG

Sprint 3 closure for v2.8.0. Brings the 2 new top-level domains
(business-operations + commercial) to release-ready by extending the
cross-platform sync infrastructure, the docs generator, and the MkDocs
nav to recognize them.

## Cross-platform sync (codex / gemini / hermes)

- scripts/sync-codex-skills.py — SKILL_DOMAINS extended with
  business-operations + commercial. Regenerated .codex/skills/ symlinks
  for 15 new skills + .codex/skills-index.json with full descriptions.
- scripts/sync-gemini-skills.py — DOMAIN_MAP extended with all 5 v2.7.0+
  v2.8.0 top-level domains (productivity, marketing-top-level, research,
  business-operations, commercial). +30 items synced.
- scripts/sync-hermes-skills.py — DOMAIN_DIRS extended with
  business-operations + commercial.

## Docs generation (Pass 2 command/agent discovery)

scripts/generate-docs.py extended with:

- DOMAINS dict extended with business-operations (sort=13) and commercial
  (sort=14) entries.
- Pass 2 for agent discovery — walks <domain>/agents/<agent>.md
  (v2.8.0 pattern), in addition to <domain>/<plugin>/agents/<agent>.md
  (legacy pattern).
- Pass 2 for command discovery — walks <domain>/commands/<cmd>.md
  (v2.8.0 pattern) AND <domain>/<skill>/commands/<cmd>.md (v2.7.0
  pattern). Previously, only root-level commands/*.md were discovered;
  35 commands were orphaned (v2.7.0 capture/pulse/landing/etc. +
  all v2.8.0 commands).

Result: 311 skill pages + 75 agent pages + 69 command pages = 455
total. Up from 311 + 73 + 34 = 418.

## MkDocs nav

mkdocs.yml updated with:

- Business Operations section (7 sub-skill nav entries)
- Commercial section (8 sub-skill nav entries)
- 2 new orchestrator agents added to Agents nav
- 17 new v2.8.0 slash commands added to Commands nav

MkDocs build succeeds (non-strict) in ~17s. Strict mode flags 3 pre-
existing broken links in older content (cs-aeo, grill-with-docs) —
out of scope for v2.8.0.

## CHANGELOG.md

v2.8.0 entry rewritten from "Sprint 1 only" to the full Sprint 1 + 2 + 3
view. All 13 sub-skills documented with canon attribution. Stats updated:

- 313 -> 328 skills (+15)
- 12 -> 14 top-level domains
- 60 -> 77 slash commands (+17)
- 402 -> 441 Python tools (+39)
- 542 -> 581 reference docs (+39)
- 46 -> 48 cs-* agents (+2)
- 57 -> 59 marketplace plugins (+2)
- 34 -> 69 documented commands in MkDocs (+35)

## Root CLAUDE.md

Updated Current Scope + Current Version to reflect v2.8.0 (released)
status. Sprint 1 "in-flight" -> "complete". Counts updated to
328 skills / 441 tools / 77 commands.

## Per-skill audit (scripts/audit_skills.py)

Ran across 329 total skills. All 13 v2.8.0 sub-skills audited with
skill_review_checklist_runner.py: 1 score 5/6, 7 score 4/6, 4 score
3/6, 1 score 2/6 (knowledge-ops). Dominant failure mode: rule #2
"SKILL.md under 100 lines" — known tension with our deliberate
Forcing-question library depth (mandatory per user direction). Tracked
as ADVISORY for skills that deliberately expose extended grill
discipline.

## Plugin manifest validation

scripts/check_plugin_json.py --all passes (exit 0) for all 47 plugin
manifests including the 2 new ones. The PR #690 validator recognizes
the source extension field per CLAUDE.md.

https://claude.ai/code/session_015bBb4HzWCf5HH5QK2TGtnW

2026-05-19 06:02:00 +00:00

3.1 KiB

Raw Blame History

title	description
/cs-handoff — Slash Command for AI Coding Agents	/cs:handoff <next-session-focus> — Compact the current conversation into a handoff document for a fresh agent. Tailored to next-session focus. Slash command for Claude Code, Codex CLI, Gemini CLI.

/cs-handoff

:material-console: Slash Command :material-github: Source

Command: /cs:handoff <next-session-focus>

Hand off the current conversation to a fresh agent. Tailored to the focus argument.

When to Run

Ending a long session; want continuity
Switching contexts mid-flight
Handing work to another team/person/agent
Starting a parallel session that needs current state

The Five Sections (per Matt Pocock)

Goal of next session — outcome the next session must achieve (tailored to focus)
State of play — done / in-progress / blocking, with paths + refs
Open decisions — what the next agent must decide, with options + current leans
Skills to use — concrete list from skill_recommender.py
Artifacts — paths + URLs ONLY (never inline content)

Hard Rule (Matt's)

"Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead."

The artifact_deduplicator.py enforces this — FAIL verdict blocks the handoff.

Workflow

# 1. Generate template tailored to focus
python ../skills/handoff/scripts/handoff_template_generator.py \
  --next-focus "<focus from command argument>" \
  --mktemp

# 2. Fill in the 5 sections from current conversation state

# 3. Pre-flight: dedup check
python ../skills/handoff/scripts/artifact_deduplicator.py path/to/draft.md
#   CLEAN or WARN (with justified findings) → proceed
#   FAIL → refactor; replace duplicated content with refs

# 4. Populate skills section
python ../skills/handoff/scripts/skill_recommender.py path/to/draft.md
#   Use top recommendations for "Skills to use"

# 5. Share the file path. Next agent reads + acts.

Tailoring Logic

Focus argument keyword	Section emphasis
ship/deploy/PR	Deployment commands, checks, approvers, rollback
review/audit	Checklist, sensitive files, similar patterns
debug/fix/investigate	Symptom, repro steps, tried-already
design/plan/scope	Outcome, constraints, rejected alternatives
test/qa	Test plan, existing coverage, edge cases
(other)	Immediate action, blocker, files, open decisions

Length Target

50-100 lines. Anything longer probably duplicates an artifact.

Agent: cs-handoff-author
Skill: handoff
Adjacent: /cs:caveman, /cs:grill-me, /cs:write-a-skill

Version: 1.0.0 Derived: Matt Pocock's handoff (MIT) + this repo's wrapper

3.1 KiB Raw Blame History