claude-skills/scripts
Claude 5954dfcce1
cleanup(engineering): address remaining 7 polish items from PR #718 bot review
Bundle of low-medium-severity follow-ups that were deferred when PR #720
landed the 3 blocking bugs. None of these silently break correctness —
they're discoverability, consistency, and convention gaps.

Bugs / code-quality:

1. fullstack_decision_engine.py: asymmetric cadence matching
   `inputs.cadence in target or target in inputs.cadence` produced
   asymmetric results — "per-pr" matched "per-pr-with-gates" but not
   vice versa. Profile cadences are intentional alternatives joined
   by "-or-" (e.g. "weekly-or-on-demand" → {weekly, on-demand}); now
   parsed explicitly with "-with-..." modifier suffixes stripped.

   Verified:
     cadence=per-pr → matches per-pr, per-pr-with-gates, daily-or-per-pr
     cadence=daily  → matches daily-or-per-pr (only)
     cadence=on-demand → matches weekly-or-on-demand

2. fullstack_decision_engine.py: rename weight_total/weight_matched
   to w_total/w_matched. Backend and frontend engines already use the
   short form; this aligns the three files as a family.

3. sync-gemini-skills.py: 3-way name collision in dedup logic
   The naive `if name in seen_names: name = parent-name` handled one
   collision but not two. Three "status" skills under "skills" parent
   dirs produced two entries both named "skills-status". Now suffixes
   with -2, -3, ... so each entry has a unique index name. Eliminates
   the duplicate-name ambiguity surfaced when checking PR #713.

Discoverability:

4. senior-fullstack/SKILL.md: surface fullstack_decision_engine.py in
   the labeled "Tools" section at the top. Previously only mentioned
   inline in the body (5 references buried in the Stack Decision Matrix
   section); not findable when scanning the SKILL.md.

Conventions / v2.8.0 compliance:

5. commands/cs-{fullstack,backend,frontend}-review.md: add explicit
   "## Forcing-question library" section header per the v2.8.0
   convention. Each lists the 7 questions inline with a pointer to
   the canonical reference file.

6. agents/engineering/cs-{fullstack,backend,frontend}-engineer.md:
   alphabetize the specialist list in the description field (annotated
   that workflow body order remains dependency-driven). Makes the
   three agent descriptions consistent as a family.

7. agents/engineering/cs-{backend,frontend}-engineer.md: promote the
   "Cross-agent invocation" content out of Workflow 3 into a dedicated
   "## When invoked as fork target" section with an explicit question-
   skip table per parent agent (cs-fullstack-engineer, cs-cto-advisor,
   cs-vpe-advisor, cs-ciso-advisor for backend; cs-fullstack-engineer,
   cs-content-creator, cs-product-manager for frontend). Closes the
   cross-agent contract gap the bot flagged.

Not changed:

- CLAUDE.md plugin-schema section (already corrected in #715; bot's
  "stale text" claim was incorrect — it was reading the cumulative diff)
- Workflow body specialist order (intentional dependency order; would
  break the SLO-first → API → DB → migration → observability sequence)

Verification:
- All 3 decision engines: --sample → exit 0
- Cadence matching: 3 test cases pass cleanly
- check_plugin_json.py --all → 0 FAIL, 0 WARN, 69 OK
- sync-gemini-skills.py → 392 unique names (was 391 unique / 1 dupe)
2026-05-21 13:47:08 +00:00
..
audit_skills.py feat(scripts): add audit_skills.py — repo-wide write-a-skill validator runner 2026-05-13 23:25:55 +00:00
check_plugin_json.py fix(plugin-schema): align with live Claude Code spec — migrate to "./"-prefixed skills field 2026-05-21 07:03:11 +00:00
codex-install.bat Dev (#44) 2026-01-23 09:09:42 +01:00
codex-install.sh Dev (#44) 2026-01-23 09:09:42 +01:00
convert.sh fix(integrations): update find depth in convert.sh for new repo structure 2026-05-12 09:56:39 +03:00
extract_release_notes.py feat(release): auto-tag + GitHub Release from CHANGELOG on push to main 2026-05-19 04:00:06 +00:00
gemini-install.sh feat: add Gemini CLI + OpenClaw support, fix Codex missing 25 skills 2026-03-09 14:58:41 +01:00
generate-docs.py chore(v2.8.0-sprint3): cross-platform sync + docs generation + MkDocs nav + CHANGELOG 2026-05-19 06:02:00 +00:00
install.sh feat(integrations): change Augment from flat rules to skill bundles 2026-04-25 04:48:41 +05:30
openclaw-install.sh fix(ci): fix workflow errors + add OpenClaw support (#222) 2026-02-24 17:33:21 +01:00
review-new-skills.sh feat(ci): add automated Tessl skill quality review on PRs 2026-04-07 12:21:30 +02:00
sync-codex-skills.py chore(v2.8.0-sprint3): cross-platform sync + docs generation + MkDocs nav + CHANGELOG 2026-05-19 06:02:00 +00:00
sync-gemini-skills.py cleanup(engineering): address remaining 7 polish items from PR #718 bot review 2026-05-21 13:47:08 +00:00
sync-hermes-skills.py chore(v2.8.0-sprint3): cross-platform sync + docs generation + MkDocs nav + CHANGELOG 2026-05-19 06:02:00 +00:00
sync_skill_bundles.py chore(phase-0): add dual-publish + plugin.json validation tools 2026-05-09 05:54:15 +00:00