Commit graph

841 commits

Author SHA1 Message Date
Claude
1f40d7ef1d
docs(megaprompts): add 11 patent prior-art + landscape skill
Adds the patent skill mega prompt — third in the research pack and the
first new skill in the v2 expansion. Non-generic by design: refuses to
be "patent help" and commits to one of five sub-use-cases via the
grill-me intake before any search runs. Each sub-use-case dictates a
distinct search strategy:

  - Novelty search: narrow + claims-text focused
  - Freedom-to-operate: broad + active patents only, jurisdiction-filtered
  - Competitive landscape: breadth + filer tally + CPC trends
  - Acquisition diligence: assignee-specific + assignment-chain
  - Litigation prior-art: target-patent-anchored + pre-priority art

Grill-me intake (max 6 questions, one at a time, dependency-ordered):
invention description (refuses generic answers), sub-use-case commitment
(forcing choice), jurisdictions (Q2-dependent), known prior art anchor,
risk tolerance, attorney-status disclaimer (only for novelty/FTO).

Search sources: Google Patents (workhorse), Espacenet (global), USPTO
PPS (US), Lens.org BYOK (citation graph). CPC/IPC classification
follow-up query mandatory after initial hits. Family resolution
deduplicates same-invention filings across jurisdictions.

DOCX output (8 sections): executive summary + verdict, closest prior art
with extracted independent claim 1, patent landscape, citation graph,
geographic coverage, FTO flags, sub-use-case-specific strategy + design-
around suggestions, audit log. Inherits research-pack conventions:
1 q/sec sequential, three-count tracking, retry-once-after-3s, stop-
after-3-failures, plan-tier detection, source discipline, attorney-
consultation disclaimer mandatory where Q2 has legal consequences.

Trademark, copyright, and trade-secret questions explicitly out of scope.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 09:43:04 +00:00
Claude
ac543b0919
docs(megaprompts): add 10 recommended reading list skill
Adds the final mega prompt in the research pack. Generates the
recommended-reading-list skill: parses a course syllabus (PDF / DOCX /
text / pasted / image), extracts topics + learning outcomes (inferring
3-5 outcomes if missing), groups topics into 6-12 sections, runs 1-2
targeted Consensus searches per section with applied-domain weaving
(e.g., "enzyme kinetics food processing applications", not just "enzyme
kinetics"), selects 1-3 papers per section (15-25 total), and writes
plain-language summaries + Bloom-higher-order discussion questions tied
to specific learning outcomes.

Uses a bundled JavaScript helper at scripts/generate_reading_list.js
for DOCX assembly: takes JSON input + output path CLI args, produces a
title page, intro with consensus.app link, boxed learning-outcomes
section, numbered hyperlinked papers per section heading with summary
+ discussion-question lines, and a footer. JSON schema documented in
the skill.

Inherits the same research-pack conventions as 08 and 09: 1 query/sec
sequential execution, plan-tier awareness (3/search free, more on Pro),
strict source discipline (only cite this session's Consensus results),
three-count tracking surfaced in chat audit summary, retry-once-after-
3s, stop-after-3-failures, group-and-confirm before searching, full
untruncated ExternalHyperlink URLs, and 7 documented failure modes.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 05:02:26 +00:00
Claude
df57ab25c6
docs(megaprompts): add 09 literature review helper skill
Adds the mega prompt that generates the literature-review-helper skill —
research pack #2. Produces a "launching pad" orientation document
(not a finished review) via one broad Consensus reconnaissance search,
PICO-default framework selection with SPIDER / Decomposition / hybrid
fallbacks, an interactive checkpoint (framework breakdown table + depth
selector), and a configurable search budget: Quick (5) / Standard (10) /
Deep (20) — each fully allocated with explicit reasoning across
sub-area, review-article, era-gated, and follow-up searches.

Adds cross-search intelligence (repeat-hit papers as foundational
signal, recurring authors as dominant groups, citations-per-year as
seminal-work proxy) and an 8-section DOCX (topic overview, priority
reading order, field timeline, sub-area guides with Boolean strings,
key research groups, open gaps with why-they-matter, hyperlinked
bibliography, audit log).

Inherits the research-pack conventions established by skill 08:
1 query/sec sequential Consensus execution, plan-tier detection from
first response, three-count tracking (searches / unique papers / cited),
retry-once-after-3s, stop-after-3-failures, strict source discipline,
and standard docx library patterns (LevelFormat.BULLET, ExternalHyperlink
with full untruncated URLs, dual-width tables, post-save validation).

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 05:01:04 +00:00
Claude
630b41642a
docs(megaprompts): add 08 Consensus grant finder skill
Adds the mega prompt that generates the NIH grant-finder skill — first
of the research pack. Combines a 5-facet Consensus positioning analysis
(established / stakes / current approaches / adjacent methods / gaps)
with RePORTER POST queries (narrow AND + broad OR) executed via
bash_tool + curl, NOSI fetches via web_fetch, and a 9-section editable
DOCX output (executive summary, positioning with gap quotes + draft
Significance/Innovation, target institutes, grant opportunities with
hyperlinked FOAs, funded overlap, study sections, strategic recs +
mandatory program officer rec + submission timeline, references, audit
log).

Locks in the research-pack shared conventions: sequential 1 query/sec
Consensus execution, plan-tier detection via "Found N, showing top M",
strict source discipline (only cite this session's tool results, label
training-knowledge as reference), three-count tracking (sent / shown /
cited), retry-once-after-3s policy, stop-after-3-consecutive-failures,
dynamic fiscal-year window, scope+career-stage mechanism matching, and
embedded mechanism + submission-timeline reference tables. Scoped
NIH-only with non-NIH funders flagged out at intake.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:59:14 +00:00
Claude
7d9ca65309
docs(megaprompts): add 07 email-triage execution skill
Adds the mega prompt that generates the email-triage recurring-execution
skill — the second half of the paired email pack. Knowledge-base file
contracts match the 06 email-setup output verbatim: core required
(email-taxonomy.md, email-patterns.md), optional core (evaluation-
framework.md, rate-card.md), evolving read+update (blocklist.md,
tracker.md), plus the Email/triage-log/ directory for per-run logs.

Specifies the 10 execution steps: 9-hour-overlap search window, two-
query email search (primary + starred-unread), taxonomy classification
with skip-reads on lowest priority, conditional sender research, four-
category recommendations (TAKE/CONSIDER/PASS/FLAG), draft creation
honoring patterns.md voice, format-honoring report delivery with HTML
inline-CSS for Gmail, KB updates + observed-override learning loop
after 5+ runs, internal triage log, and empty-inbox handling that still
surfaces overdue tracker items.

Hard rule stated prominently in multiple places: DRAFTS ONLY — NEVER
SEND. Provider-agnostic adapter pattern (Gmail MCP, Outlook MCP, IMAP),
fail-fast on missing KB (direct user to email-setup), privacy boundary
(no credentials in KB), trigger phrases, anti-patterns, 7+ failure
modes, and a validation checklist.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:57:54 +00:00
Claude
7c3ddf0b1d
docs(megaprompts): add 06 email-setup onboarding skill
Adds the mega prompt that generates the email-setup interview skill —
the first half of the paired email pack. Specifies the exact knowledge-
base file contract at \${WORKSPACE}/Email/ (email-taxonomy.md,
email-patterns.md, optional evaluation-framework.md + rate-card.md,
blocklist.md, tracker.md, triage-log/) that the companion email-triage
skill must consume verbatim.

Documents the 8 interview sections (big picture, categories, voice via
3-5 real sent-email samples, conditional evaluation framework, blocklist
seeding, current state, report preferences, handoff), conversational
pacing discipline (no batched questions, explain why each one matters),
modular skip-logic for non-applicable sections (e.g., no rate card if
no pricing), privacy boundary (never persist credentials), and re-run
safety (per-file replace/merge/skip prompt).

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:56:30 +00:00
Claude
e02647f11e
docs(megaprompts): add 05 brain-dump organizer skill
Adds the mega prompt that generates the brain-dump capture-and-organize
skill. Specifies the four-section output (Projects & Ideas with embedded
questions/decisions, flat Tasks list, Connections grounded in real
workspace inspection, concrete How-I-Can-Help offers ending with a
directive question), and the five operating principles (capture-all,
complexity-matching, voice preservation, ambiguity flagging, approval-
gate before any non-organizing action).

Documents context-aware workspace detection (CLI Glob/Grep, web project
files, connected MCPs, or explicit inaccessibility statement), strict
no-fabrication rule for Connections, six failure modes including short
dumps and conflicts, explicit + implicit trigger phrases, anti-patterns
(no corporate-ifying user voice, no forced 4-section structure on small
dumps), and a validation checklist.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:55:11 +00:00
Claude
dcaf7ac4f4
docs(megaprompts): add 04 landing page generator skill
Adds the mega prompt that generates the landing-page skill: premium
single-file HTML output with inline CSS/JS, Inter + GSAP via CDN only.
Specifies three required sections (hero, features, closing CTA), five
animation patterns (GSAP entrance with gsap.set() FOUC guard, mouse
parallax with two depth layers, ScrollTrigger card reveals, CSS-keyframe
floating shapes, scroll indicator), default dark-navy + teal palette as
CSS custom properties with explicit override pattern, responsive
breakpoints (900px/580px), and accessibility minimums.

Documents configurable OUTPUT_DIR variable, kebab-case filename derived
from product name, both CLI (write to disk) and web (HTML artifact)
delivery modes, content-fallback strategy for sparse inputs, six failure
modes, trigger phrases, anti-patterns, and a validation checklist.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:52:20 +00:00
Claude
4dce9ac2fb
docs(megaprompts): add 03 NotebookLM automation skill
Adds the mega prompt that generates the NotebookLM browser-automation
skill. Specifies the four core actions (read/extract, add sources,
generate Studio outputs, create new notebook), tool-agnostic browser
automation language, screenshot-first + find-before-click discipline,
and an explicit async-wait rule: Studio generations (especially Audio
Overview) must not block the session.

Documents login-wall handling (stop, never auto-login), synthesized-
content-as-source pattern, mandatory custom Studio prompts (with ≥ 4
concrete examples required), portability constraints (CLI/computer-use
or Chrome extension only — fails fast on web), trigger phrases, anti-
patterns, 7+ failure modes, and a validation checklist.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-15 04:50:51 +00:00
Claude
2aaaed6624
docs(megaprompts): add 02 take-a-step-back reflection skill
Adds the mega prompt that generates the take-a-step-back metacognitive
reflection skill. Specifies the 5-dimension framework (macro, gap,
reflective inquiry, bias check, contextual alignment), explicit + implicit
invocation signals, honest-output discipline (don't manufacture problems
when on track), conversation re-read from the top, and a flowing-prose
output format with a mandatory closing directional recommendation
(continue / pivot / pause).

Documents trigger phrases, the 5 cognitive biases to check, error
handling for short conversations and solid directions, anti-patterns,
and a validation checklist. Skill is pure-reasoning and fully portable
across CLI and web.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-14 21:03:30 +00:00
Claude
72cd44a466
docs(megaprompts): add 01 last-30-days research skill
Adds the mega prompt that generates the last-30-days multi-source
research skill. Specifies parallel execution across Reddit, Hacker News,
web search, and optional X/Twitter phases; configurable time window
(7d/14d/30d/60d/90d); graceful per-source degradation; citation
discipline; and a fixed output markdown structure (TL;DR, per-source
findings, cross-platform patterns, takeaways, content angles).

Includes trigger phrases, frontmatter spec, anti-patterns, portability
notice (CLI vs web — X phase skipped in web), failure-mode table, and a
validation checklist to run before delivery.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-14 21:01:01 +00:00
Claude
4a328def24
docs(megaprompts): add 00 master orchestrator
Adds the master orchestrator that chains all 10 skill mega prompts.
Defines three generation modes (full library, selected pack, single
skill), 6-phase workflow (pre-flight, dependency validation, generation,
per-skill validation, cross-skill validation, delivery), research-pack
shared conventions (rate limit, plan-tier detection, source discipline,
three-count tracking, retry policy, audit log, DOCX patterns), quality
standards, anti-patterns, and failure-mode table.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-14 20:58:19 +00:00
Claude
d9c3a70db5
docs(megaprompts): scaffold directory with library README
Scaffolds the megaprompts/ directory with the library README that
describes the 10-skill mega-prompt set, quality standards, pack
groupings, portability matrix, and customization variables. Individual
mega prompt files (00-10) will follow in subsequent commits.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
2026-05-14 20:55:49 +00:00
Alireza Rezvani
0796e1d70a
Merge pull request #650 from alirezarezvani/dev
Some checks failed
Deploy Documentation to Pages / build (push) Has been cancelled
Sync Codex Skills Symlinks / sync (push) Has been cancelled
Deploy Documentation to Pages / deploy (push) Has been cancelled
2026-05-14 12:23:54 +02:00
Alireza Rezvani
d1773450e0
Merge pull request #649 from alirezarezvani/feature/release-v2.6.1
Some checks are pending
Sync Codex Skills Symlinks / sync (push) Waiting to run
2026-05-14 07:29:13 +02:00
Claude
af55472ffe
release(v2.6.1): meta-skill maturity — validator + descriptions + audit tool
Promotes the v2.6.1 cleanup work (already merged to dev via #646 + #647 +
#648) to a tagged release. Updates the 3 release artifacts:

marketplace.json:
- Top-level metadata.version: 2.6.0 → 2.6.1
- No new plugin entries; this is a cleanup release (validator improvements +
  21 placeholder description fixes + audit tool)

CHANGELOG.md:
- New v2.6.1 entry above v2.6.0
- Documents validator trigger expansion (30 skills auto-reclassified)
- Documents 21 placeholder description fixes (10 from #647 + 11 from #648)
- Documents quality_gates_for_skills.md update (binding-new vs advisory-legacy)
- Aggregate audit improvements: PASS 4 → 9 (+5); WARN 111 → 137 (+26);
  FAIL 183 → 152 (-31); Missing-trigger 119 → 68 (-51)
- 31 skills total lifted from FAIL → WARN/PASS in v2.6.1

CLAUDE.md:
- Current Version: v2.6.0 → v2.6.1
- New v2.6.1 Highlights section above v2.6.0
- Preserves full v2.6.0 highlights for version history continuity

No code changes in this commit (release-artifacts only).
JSON valid (marketplace.json parses cleanly).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-14 05:24:38 +00:00
alirezarezvani
468a31ef87 chore: sync codex skills symlinks [automated] 2026-05-14 05:14:10 +00:00
Alireza Rezvani
fa61169ccf
Merge pull request #648 from alirezarezvani/feature/v2.6.2-remaining-placeholders 2026-05-14 07:13:54 +02:00
Claude
1b152ab675
fix(v2.6.2): fix remaining 11 placeholder descriptions
Continues the v2.6.1 cleanup (PR #647). Fixes the final 11 placeholder
descriptions identified in the audit — skills whose description field was
literally just the skill name from a v2.0.0 batch import.

Skills fixed across 4 domains:

c-level-advisor (executive-mentor):
- executive-mentor/skills/challenge — pre-mortem plan analysis ("imagine
  it's 12 months from now and this plan failed")
- executive-mentor/skills/board-prep — adversarial board meeting prep

engineering (POWERFUL tier):
- git-worktree-manager — parallel feature work with Git worktrees
- skill-tester — meta-skill QA (structure + script + quality scoring)
- monorepo-navigator — Turborepo / Nx / pnpm / Lerna navigation
- env-secrets-manager — env-var hygiene + secrets rotation
- agent-workflow-designer — production-grade multi-agent workflows

engineering-team:
- incident-commander — incident response framework (detection → resolution)
- email-template-builder — React Email + provider integration (Resend,
  Postmark, SendGrid, AWS SES)
- stripe-integration-expert — subscriptions, webhooks, billing patterns

business-growth:
- contract-and-proposal-writer — jurisdiction-aware business documents
  (US/EU/UK/DACH; contracts, SOWs, NDAs, MSAs)

Each new description: ≤1024 chars, third person, action verb in first
sentence, "Use when ..." trigger in second sentence per Matt Pocock's rule.

All 11 descriptions PASS or WARN on skill_description_validator.py:
- 6 PASS: git-worktree-manager, skill-tester, monorepo-navigator,
  env-secrets-manager, incident-commander, email-template-builder
- 5 WARN: challenge, board-prep, agent-workflow-designer,
  stripe-integration-expert, contract-and-proposal-writer (warnings
  from other rules — SKILL.md > 100 lines, terminology drift — not
  the description itself)

Cumulative impact across v2.6.0 → v2.6.1 → v2.6.2:
- PASS:           4 (1%) → 7 (2%) → 9 (3%)        [+5]
- WARN:         111      → 134     → 137           [+26]
- FAIL:         183      → 157     → 152           [-31]
- Missing-trigger: 119   → 79      → 68            [-51]

31 skills total lifted from FAIL → WARN/PASS across v2.6.1 + v2.6.2.

Audit baseline preserved at 298 real skills (excludes auto-generated
.gemini/.codex/.cursor/.cline bundles and template fixtures).

Next cleanup target (v2.6.3 candidate): the 27% terminology-consistency
drift (agent/bot, skill/tool mixing) — bigger scope, requires careful
prose edits per file.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-14 05:08:23 +00:00
alirezarezvani
236811100a chore: sync codex skills symlinks [automated] 2026-05-14 05:02:37 +00:00
Alireza Rezvani
d3ea6bffce
Merge pull request #647 from alirezarezvani/feature/use-when-trigger-fixes 2026-05-14 07:02:22 +02:00
Claude
d3c822a517
fix(v2.6.1): expand validator trigger patterns + fix 10 placeholder descriptions
Follow-up to v2.6.0. Uses the audit_skills.py tool (shipped in #646) to identify
real bugs vs validator false-positives across 298 repo skills, then fixes both.

Three coordinated changes:

1. Validator trigger pattern expansion (write-a-skill internal tools)
- Old: only "Use when", "Use for", "Invoke when", "Trigger when" recognized
- New: + "Use before/during/after/while", "Invoke before/after", "Apply when",
  "Run when/before"
- Why: 11 legacy skills had semantically-valid triggers (e.g., gdpr-audit-prep
  says "Use before annual GDPR review") that the v2.6.0 validator wrongly
  flagged as missing. Natural English variants now accepted.
- Impact: 30 skills reclassified from FAIL → WARN/PASS automatically.
- Karpathy complexity: 100/100 (PASS) on both modified validators.

2. Ten placeholder descriptions fixed in engineering/skills/
The audit revealed 21 skills (~7% of repo) with broken descriptions that
were literally just the skill name (e.g., description: "Migration Architect").
These were real bugs from a v2.0.0 batch import where the description field
was never filled in. Top-10 fixed in this PR (POWERFUL-tier, high-visibility):
- migration-architect: zero-downtime migration planning + rollback strategy
- dependency-auditor: vulnerabilities + license + safe-upgrade audit
- codebase-onboarding: codebase analysis + onboarding doc generation
- ci-cd-pipeline-builder: pragmatic CI/CD from project stack signals
- mcp-server-builder: MCP servers from OpenAPI contracts (Python + TS)
- observability-designer: metrics + logs + traces + SLI/SLO design
- api-design-reviewer: REST design review + breaking-change detection
- performance-profiler: Node/Python/Go profiling + flamegraphs + load tests
- changelog-generator: Conventional Commits → release notes automation
- runbook-generator: operational runbooks from service name + templates

Each new description: ≤1024 chars, third person, action verb in first
sentence, "Use when ..." trigger in second sentence per Matt Pocock's rule.
Remaining 11 placeholder descriptions tracked for v2.6.2.

3. Quality-gates reference updated (Option C: legacy advisory)
quality_gates_for_skills.md now explicitly documents the binding-for-new
vs advisory-for-legacy split. The 6-item checklist remains BLOCKING for
post-v2.6.0 skills and ADVISORY for the 298 legacy SKILL.md files. Audit
report drift is tracked separately; PASS count is the metric to grow, not
a force-march-to-Friday deadline.

Aggregate audit improvement (against the 298 real-skill cohort):
- PASS:  4 (1%) → 7 (2%)
- WARN:  111 (37%) → 134 (45%)
- FAIL:  183 (61%) → 157 (53%)
- "Missing trigger" failures: 119 (39%) → 79 (26%)

26 skills total lifted from FAIL → WARN/PASS in this PR. Highest-leverage
fix per hour of any v2.6.x cleanup since the v2.6.0 release.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-14 04:52:51 +00:00
Alireza Rezvani
e37bc1a125
Merge pull request #646 from alirezarezvani/feature/skill-audit-tool 2026-05-14 06:44:25 +02:00
Claude
507f62610f
feat(scripts): add audit_skills.py — repo-wide write-a-skill validator runner
Adds a small stdlib-only orchestration script that runs the
skill_review_checklist_runner.py (shipped in v2.6.0) across every SKILL.md
in the repo and aggregates results.

Output:
- Total skills audited (PASS / WARN / FAIL / ERROR counts + percentages)
- Failure breakdown by rule (which of Matt's 6 checklist items fail most)
- Top-10 worst offenders (skill folder + specific failing rules)

Excludes auto-generated tool-specific symlinks (.gemini, .codex, .cursor,
.cline, /site/, /.git/) and template fixtures (templates/, assets/sample-skill).

Use case: periodic audit of skill-library hygiene. Re-run after each batch
of new skills to catch drift early. Produced the punch list that informed
the v2.6.1 cleanup planning (40% of repo skills miss "Use when" triggers;
88% exceed Matt's 100-line ceiling — both flagged for triage).

Stdlib-only. No external dependencies. Runs in ~30s on a 298-skill repo.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 23:25:55 +00:00
Alireza Rezvani
f776236fb9
Merge pull request #645 from alirezarezvani/dev
Some checks are pending
Deploy Documentation to Pages / build (push) Waiting to run
Deploy Documentation to Pages / deploy (push) Blocked by required conditions
Sync Codex Skills Symlinks / sync (push) Waiting to run
2026-05-14 01:17:36 +02:00
Alireza Rezvani
db613f775c
Merge pull request #644 from alirezarezvani/feature/release-v2.6.0 2026-05-14 01:12:25 +02:00
Claude
cc8ff7c2d6
docs(v2.6.0): add Pocock skills/agents to docs site + refresh stale counts
Adds the 4 new Matt Pocock-derived skills + 4 cs-* agent pages to the
github.io docs site (Material for MkDocs). Refreshes stale skill counts
across index.md + mkdocs.yml site_description.

Auto-generated via scripts/generate-docs.py (the established generator
that v2.5.7 fixed the dedup bug in):

New skill pages (docs/skills/engineering/):
- caveman.md
- grill-me.md
- handoff.md
- write-a-skill.md

New agent pages (docs/agents/):
- cs-caveman-mode.md
- cs-grill-master.md
- cs-handoff-author.md
- cs-skill-author.md

mkdocs.yml nav additions:
- Engineering POWERFUL section: 4 new entries after Ship Gate, labeled
  "(Matt Pocock-derived)" for clear attribution
- Agents section: 4 new entries after CS VPE Advisor, same labeling
- site_description: 268 → 272 skills; 33 → 37 cs-* agents; 21 → 25 /cs:*
  commands; explicit Pocock quartet callout

docs/index.md refresh:
- title: 246 → 272 Agent Skills
- description: refreshed with v2.6.0 Pocock-quartet callout
- hero subtitle: 246 → 272 skills; 20 → 37 cs-* agents
- "What's Inside" cards: 246 → 272 Skills; 20 → 37 Agents

Side-effect (additive only, non-blocking):
- 2 pre-existing ra-qm-team skills (EU AI Act Specialist + ISO 42001
  Specialist) finally generated their canonical docs pages (they had
  SKILL.md files but no docs/ entries). The long-named dual-publish
  duplicates were removed to avoid the v2.5.7 dedup regression.

Build verified: 412 HTML pages generated in 18.17s (was 357 in v2.5.7).
All 4 new skill pages + 4 new agent pages present in build output.
No new warnings from our additions (only generic Material for MkDocs
2.0 upgrade notice that pre-dates this PR).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 22:28:51 +00:00
Claude
6b0e4d48db
release(v2.6.0): Matt Pocock productivity skills — write-a-skill + caveman + grill-me + handoff
Promotes the 4 Matt Pocock-derived productivity skills (merged via #642 +
#643) to a tagged v2.6.0 release. Updates the 3 release artifacts:

marketplace.json:
- Top-level metadata.version: 2.4.5 → 2.6.0
- Top-level description + metadata.description: 246/9 → 272 skills (4 new
  Pocock-derived productivity skills added to engineering domain count
  67 → 71); 359 → 385 Python tools; 485 → 519 references; 27 → 31 agents;
  33 → 58 slash commands
- 4 new plugin entries appended after slo-architect (development category):
  write-a-skill, caveman, grill-me, handoff (all v2.6.0)
- Each entry carries the matt-pocock keyword for grouping
- Total plugins: 39 → 43

CHANGELOG.md:
- New v2.6.0 entry at top (above v2.5.7)
- Per-skill detail with tool list + reference source counts
- Documents the "hybrid voice pattern" established for future MIT-licensed
  external skill imports (preserve upstream voice verbatim + wrapper layer
  with validators/references/cs-*/slash command + karpathy gate + attribution)
- Documents 2 known trade-offs: assumption_linter false positives on vocab-as-
  data (caveman + handoff tools) + realistic compression ratio is 20-50% not 75%

CLAUDE.md:
- Current Scope: 268 → 272 skills; 373 → 385 tools; 506 → 519 refs;
  40 → 44 agents (33 → 37 cs-*); 54 → 58 commands
- Architecture tree: engineering/ count 40 → 44 with new skill names
- New v2.6.0 Highlights section above v2.5.5 (no break in version history)

No code changes in this commit (release-artifacts only).
All JSON valid; karpathy gate not applicable (no Python touched).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 22:22:32 +00:00
Alireza Rezvani
0926abdbc5
Merge pull request #643 from alirezarezvani/feature/pocock-productivity-batch 2026-05-14 00:11:26 +02:00
Claude
5ac2a8e0d7
fix(productivity): add H1 heading to caveman/grill-me/handoff SKILL.md
test_skill_integrity.py::TestSkillMdHasH1 requires every SKILL.md to have an
H1 heading. Matt Pocock's originals didn't have H1s (just frontmatter + body)
so the verbatim preservation tripped this test on dev's CI.

Adding minimal H1 headings ("Caveman Mode", "Grill Me", "Handoff") without
modifying Matt's body content. Voice + workflow + rules preserved exactly.

Full pytest suite: 1921 passed (was 3 failed).
Write-a-skill review checklist: still PASS on all 3 SKILL.md (69/58/41 lines,
all under Matt's 100-line ceiling).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 21:54:09 +00:00
Claude
6b2c2c3856
feat(productivity): derive caveman + grill-me + handoff from Matt Pocock (MIT)
Stream B PR 2 of 2 — three sibling productivity skills built using the
write-a-skill validators shipped in PR 1 (#642). The validators caught the
real issues (line counts, nesting depth, false-positive vocabulary in data
constants); the false positives are documented in the PR description.

Each skill follows the same wrapper pattern established in PR 1:
- Matt's SKILL.md content preserved verbatim per MIT license
- Attribution in README.md + plugin.json + SKILL.md frontmatter + every file footer
- 3 stdlib Python tools per skill (no LLM calls, embedded samples, JSON output)
- 3 in-depth references per skill (7-8 authoritative sources each)
- cs-* persona agent + /cs:* slash command
- Karpathy-coder validation: 100/100 complexity across all 9 tools

caveman (token-compression mode):
- Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/caveman
- Tools: caveman_compressor (apply Matt's rules deterministically, ~20-50%
  reduction on real prose, 75% upper bound), token_savings_estimator (chars/token
  heuristic + $/Mtok cost extrapolation), caveman_lint (detect banned vocab
  with code-block + exception-zone whitelisting)
- References: compression_principles (what to cut vs preserve, 8 sources),
  when_caveman_backfires (5 failure modes + auto-clarity exception, 7 sources)
- Agent: cs-caveman-mode (persistence-enforced)
- Command: /cs:caveman

grill-me (relentless plan interrogator):
- Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me
- Tools: decision_tree_extractor (6 branch kinds: intent/choice/open/tradeoff/
  dependency/question), question_generator (forcing questions with recommended
  answers + dependency-aware ordering), grill_session_tracker (JSON-backed
  state in ~/.grill_sessions/ for multi-day grills)
- References: forcing_question_patterns (6 patterns + soft-question anti-
  patterns, 8 sources), when_to_stop_grilling (3 stop conditions + 3 keep-going
  conditions + diminishing-returns test, 7 sources)
- Agent: cs-grill-master (one-question-at-a-time enforcer)
- Command: /cs:grill-me

handoff (conversation continuity generator):
- Derived from https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff
- Tools: handoff_template_generator (5-section scaffold tailored to next-
  session focus across 5 emphases: deploy/review/debug/design/test/default,
  honors Matt's mktemp -t handoff-XXXXXX.md convention),
  artifact_deduplicator (detects PRD/ADR/issue/commit/long-code-block
  duplication with reference suggestions), skill_recommender (matches handoff
  content to 14 skills in this repo, ranked by signal strength)
- References: handoff_structure (5 sections + tailoring logic, 7 sources),
  deduplication_discipline (5 categories of duplication + fix patterns,
  7 sources), next_session_skill_matching (recommender logic + ranking,
  7 sources)
- Agent: cs-handoff-author (no-duplication-tolerated)
- Command: /cs:handoff with argument hint per Matt's convention

Karpathy-coder validation (full sweep):
- complexity_checker: 100/100 across all 9 tools (0 findings)
- assumption_linter: documented false positives only (caveman tools contain
  banned-vocabulary STRINGS as DATA to detect/remove; handoff tools contain
  intentionally-bad fixture text in SAMPLE_HANDOFF_BAD; skill_recommender
  contains "refactor"/"complexity" as recommendation keywords)
- All 9 tools: PASS text + PASS JSON output (exit 1 on caveman_lint +
  artifact_deduplicator is intentional — embedded samples are designed to
  FAIL the respective check)
- 9 references cite 7-8 authoritative sources each

Write-a-skill validators (the meta-skill, dogfooded):
- description_validator: PASS on all 3 SKILL.md (all are <=1024 chars + third
  person + "Use when" trigger + action verb in first sentence)
- structure_validator: PASS on all 3 (folders correct, SKILL.md <100 lines,
  references one level deep, no circular refs)
- review_checklist_runner: PASS on all 3 (all 6 of Matt's checklist items)
- SKILL.md line counts: 67 (caveman) / 56 (grill-me) / 39 (handoff) — all
  under Matt's 100-line ceiling

34 files, 4,033 insertions. License: MIT (matching Matt's upstream).

Closes the Stream B Matt Pocock productivity skills derivation:
- write-a-skill (PR #642, merged)
- caveman + grill-me + handoff (this PR)

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 21:50:40 +00:00
Alireza Rezvani
6e7951d2cb
Merge pull request #642 from alirezarezvani/feature/pocock-write-a-skill 2026-05-13 23:35:14 +02:00
Claude
a31dad3a44
feat(write-a-skill): derive from Matt Pocock (MIT) + add validation wrapper
Stream B PR 1 of 2 — the skill-author skill that gives us the meta-tool to
build the rest of Matt Pocock's productivity skills (caveman, grill-me, handoff)
with consistent quality gates.

Derived from Matt Pocock's write-a-skill (MIT-licensed):
https://github.com/mattpocock/skills/tree/main/skills/productivity/write-a-skill

Matt's SKILL.md content + 3-phase workflow (Gather -> Draft -> Review) preserved
verbatim per MIT license. Attribution: README.md + plugin.json description +
SKILL.md frontmatter metadata + every file footer cites Matt + links to original.

Additions on top of Matt's original (the "hybrid voice" approach):

3 stdlib Python validation tools:
- skill_description_validator.py: 5-check verdict per Matt's 4 format rules
  (description present, <=1024 chars, third person, "Use when" trigger, action
  verb in first sentence). Action-verb vocabulary extracted as module constant.
- skill_structure_validator.py: 6-check verdict (SKILL.md present, line count,
  references when split needed, one-level-deep, no circular refs, scripts/
  folder note). Refactored to extract _list_md_in_subdir + _collect_links_for_file
  helpers to keep nesting depth <= 4 per karpathy-coder.
- skill_review_checklist_runner.py: combined verdict running all 6 items from
  Matt's review checklist. Refactored _find_nested_md helper for nesting.

4 in-depth references (each citing 7-8 authoritative sources):
- companion_tooling.md: tool catalogue + cs-* wrapper rationale
- progressive_disclosure_principles.md: 100-line ceiling + one-level-deep rule
  with sources (Matt, Anthropic, Don Norman, Pirolli & Card, Maeda, DocOps)
- description_design_patterns.md: good vs bad description patterns with sources
  (Matt, Anthropic, Garrett, Nielsen Norman, Karpathy)
- quality_gates_for_skills.md: the 6 mandatory gates + CI integration with
  sources (Matt, Humble & Farley, Kim et al., Hyrum's Law)

cs-skill-author persona agent + /cs:write-a-skill slash command:
- Forcing-question interrogator pattern matching our cs-* convention
- 6 forcing questions mirroring Matt's 6 review-checklist items
- Routes to validators + karpathy-coder gate + attribution check

Karpathy-coder validation (full sweep):
- complexity_checker: 100/100 across all 3 tools (0 findings)
- assumption_linter: CLEAN on all 3 tools
- All 3 tools: PASS text + PASS JSON output
- All 4 references cite >= 7 authoritative sources (range 7-8)

Self-validation note: this skill's own SKILL.md is 141 lines (over Matt's
100-line ceiling) because it preserves Matt's full content verbatim + adds
attribution + tooling references. The structure_validator + checklist_runner
correctly WARN on this — documented in progressive_disclosure_principles.md
as the wrapper-derived exception. README.md absorbs the attribution overhead
so SKILL.md stays close to Matt's original size.

12 files, 1,689 insertions. License: MIT (matching Matt's upstream).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 21:26:44 +00:00
Alireza Rezvani
a704bdab94
Merge pull request #641 from alirezarezvani/feature/compliance-os-phase-3 2026-05-13 22:59:52 +02:00
Claude
0a703faa7d
feat(compliance-os): Phase 3 — 12 frameworks + 205 mock audit scenarios + reuse index
Stream A Phase 3 expansion of the multi-framework compliance OS.

12-framework support (was 9):
- Added NIST Cybersecurity Framework 2.0 (voluntary; US gov-adjacent)
- Added EU NIS2 Directive 2022/2555 (binding for in-scope EU entities)
- Added HIPAA Security + Privacy + Breach Notification Rules (binding US healthcare)

framework_selector.py: 3 new framework entries + dependency edges (NIS2→27001,
HIPAA→27001) + 5 new profile triggers (processes_phi, us_healthcare_covered_entity,
us_healthcare_business_associate, nis2_essential_entity, nis2_important_entity,
adopts_nist_csf, us_government_contractor). 3 new rationale notes citing NIS2
Article 20-21, HIPAA §164.308-316, NIST CSF 2.0 functions.

cross_framework_mapper.py: NIST CSF / NIS2 / HIPAA mappings added to all 19
merged controls. NIST CSF achieves 19 mappings (17 HIGH-confidence); HIPAA 18
mappings (13 HIGH); NIS2 16 mappings (10 HIGH). All 19 controls now reach
high-reuse threshold (≥3 frameworks).

assets/mock_audit_library.json (NEW): 205 pre-built finding scenarios across:
- 12 frameworks (iso_27001:130, soc_2:97, nist_csf:76, hipaa:64, iso_42001:57,
  gdpr:42, nis2:35, iso_13485:33, eu_ai_act:20, fda_qsr:17, eu_mdr_745:9,
  iso_14971:6 — sum > total due to multi-framework scenarios)
- 26 themes (access_control, supplier_management, incident_response,
  risk_management, monitoring_logging, data_governance, data_protection_privacy,
  cryptography, secure_sdlc, vulnerability_mgmt, physical_security, change_mgmt,
  business_continuity, competence_training, asset_inventory, internal_audit,
  management_review, continual_improvement, documentation_control, aims_specific,
  ai_act_specific, qms_specific, fda_specific, hipaa_specific, nis2_specific,
  csf_specific, mdr_specific, risk_management_medical)
- 4 severity levels (34 critical, 88 major, 54 minor, 29 observation —
  IIA-consistent distribution: 14% critical, 43% major, 26% minor, 14% observation)
- All 205 IDs unique; all schema-complete

references/evidence_artifact_reuse_index.md (NEW): empirically-derived
reuse-leverage ranking of evidence artefacts across all 12 frameworks. Top-tier
artefacts (risk register, asset inventory, incident log, supplier inventory,
policy set) ranked with 25-30+ mappings × 7-8+ frameworks. Operational build
order: Phase 1 top-reuse → Phase 2 high-leverage → Phase 3 mid-leverage →
Phase 4 framework-specific. Anti-patterns + freshness discipline documented.
Cites 17 authoritative sources.

SKILL.md updated to v1.2.0 with 12-framework messaging + 205-scenario library
referenced. plugin.json bumped to v1.2.0.

Karpathy-coder validation (full sweep, including pre-merged Phase 1 + Phase 2):
- complexity_checker: 100/100 across all 10 Python tools (0 findings)
- assumption_linter: 0 findings + CLEAN verdict on Phase-3-modified tools
- All 10 tools: PASS text + PASS JSON
- mock_audit_library.json: valid; 205 scenarios; 12 frameworks
- 6/6 compliance-os references cite >= 5 authoritative sources

framework_selector smoke test (3 new profiles):
- us_healthcare → 4 frameworks (HIPAA + iso_27001 + soc_2 + iso_42001) ✓
- eu_nis2_critical → 3 frameworks (gdpr + nis2 + iso_27001) ✓
- us_gov_contractor → 3 frameworks (iso_27001 + soc_2 + nist_csf) ✓

cross_framework_mapper smoke test (all 12 frameworks enabled):
- 19 merged controls (all multi-framework, all high-reuse)
- NIST CSF: 19 mappings (17 HIGH)
- HIPAA: 18 mappings (13 HIGH)
- NIS2: 16 mappings (10 HIGH)

7 files changed, 559 insertions(+), 9 deletions(-).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 20:47:06 +00:00
Alireza Rezvani
ed31a371a8
Merge pull request #640 from alirezarezvani/feature/compliance-os-phase-2 2026-05-13 22:19:45 +02:00
Claude
c934707999
feat(compliance-os): Phase 2 — per-framework audit playbooks + personas + commands
Stream A Phase 2 expansion of the multi-framework compliance OS.

5 new audit playbook references (each citing 10-11 authoritative sources):
- ra-qm-team/skills/isms-audit-expert/references/iso27001_audit_playbook.md
  (7-phase audit workflow + Annex A scope prioritization + common findings)
- ra-qm-team/skills/qms-audit-expert/references/iso13485_audit_playbook.md
  (Design Controls + CAPA + Process Validation focus; MDR + FDA QSR cross-walk)
- ra-qm-team/skills/gdpr-dsgvo-expert/references/gdpr_audit_playbook.md
  (Article-cited audit; Article 5/6/9/30/32/33-34/35 + Schrems II transfers)
- ra-qm-team/skills/soc2-compliance/references/soc2_audit_playbook.md
  (Type II observation-period discipline + AICPA TSC + 75% ISO 27001 reuse)
- compliance-os/skills/compliance-os/references/multi_framework_audit_playbook.md
  (Integrated audit programme + cross-framework finding impact + integrated mgmt review)

5 new cs-* persona agents:
- cs-ciso-iso27001: sample-driven ISMS auditor; rejects curated audit demos
- cs-cqm-iso13485: traceability-obsessed QMS auditor; DHF + CAPA + post-market focused
- cs-dpo-gdpr: Article-cited DPO; lawful-basis + DPIA + Schrems II discipline
- cs-soc2-auditor: observation-period operator; 75% ISO 27001 reuse coordinator
- cs-fda-qsr-auditor: FDA-specific overlay on ISO 13485 (substantially harmonized
  post-Feb 2026); complaint files + MDR reporting + Form 483 response

5 new /cs:* slash commands (sub-skill pattern):
- /cs:iso27001-audit-prep: 6Q forcing interrogation (audit programme + risk + sampling)
- /cs:iso13485-audit-prep: 6Q forcing interrogation (DHFs + CAPA + post-market)
- /cs:gdpr-audit-prep: 6Q Article-cited interrogation (RoPA + DPIA + DSAR + Schrems II)
- /cs:soc2-audit-prep: 6Q observation-period interrogation (TSC + cycle skips + exceptions)
- /cs:fda-qsr-audit-prep: 6Q FDA-discipline interrogation (complaints + MDR + DHRs + Form 483)

Plugin.json updated to v1.1.0 with 5 new sub-skill references.

Builds on Phase 1 (compliance OS MVP merged in #639). Reuses existing 14 ra-qm-team
skills via cross-references; no duplication of operational depth. Each persona +
command + playbook trio routes to the existing skill's Python tools for operational
work; the new artefacts add audit-readiness discipline + cross-framework impact
tracking.

Total: 16 files, ~2,459 insertions. No Python tools added in this phase (docs +
agents + commands only). All 5 references cite 10-11 authoritative sources each
(ISO 19011, IIA IPPF, AICPA AT-C, AICPA TSC, regulation text, EDPB, NIST, ISACA,
industry retrospectives).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 19:09:19 +00:00
alirezarezvani
d10d5dd2b2 chore: sync codex skills symlinks [automated] 2026-05-13 18:08:05 +00:00
Alireza Rezvani
e07d477e16
Merge pull request #639 from alirezarezvani/claude/plan-compliance-productivity-93OQM 2026-05-13 20:07:37 +02:00
Claude
4463dc1752
feat(compliance-os): multi-framework meta-orchestrator for compliance teams
Stream A Phase 1 — Plugin 3 of 3 (compliance OS MVP).

Top-level peer of ra-qm-team/ that orchestrates the 14 ra-qm-team skills
plus the two new compliance-team-* plugins (iso42001 + eu-ai-act).

Four stdlib Python tools:
- framework_selector.py: company profile -> applicable frameworks across all 9
  (ISO 27001, 13485, 42001, 14971, EU AI Act, MDR 745, GDPR, SOC 2, FDA QSR)
  with binding-vs-certifiable priority + dependency graph
- cross_framework_mapper.py: 19 merged control themes covering access, asset,
  risk, supplier, incident, logging, change, BCP, training, data, audit, mgmt
  review, crypto, secure SDLC, vuln, physical, privacy, document control, CAPA;
  HIGH/MED/LOW confidence per framework; >= 30 atomic 27001<->SOC 2 mappings
- audit_simulator.py: 10 finding scenarios per scope with IIA-target severity
  distribution (60% observation, 0% critical for embedded sample = healthy);
  3-5 interview questions per scoped control + document-review requests
- evidence_pool_generator.py: 15 curated artefacts with reuse-leverage scoring
  (100 total (framework, control) satisfactions in embedded sample)

Four references each citing 5+ authoritative sources:
- compliance_os_pattern.md: meta-framework architecture + IMS pattern
- cross_framework_overlap.md: 9-framework control-family overlap matrix
- audit_simulation_methodology.md: ISO 19011 + IIA IPPF + AICPA AT-C principles
- evidence_management.md: reuse-leverage + retention + freshness + storage

Three cs-* persona agents:
- cs-compliance-officer: multi-framework orchestrator
- cs-aims-iso42001: ISO 42001 AIMS implementation operator
- cs-ai-act-compliance: EU AI Act Article-cited compliance operator

Three /cs:* slash commands (sub-skill pattern):
- /cs:compliance-readiness: 6-question multi-framework forcing interrogation
- /cs:aims-audit: 6-question ISO 42001 internal-audit interrogation
- /cs:ai-act-readiness: 6-question EU AI Act readiness interrogation

Two JSON asset templates for tool inputs.

Karpathy gate: complexity_checker 100/100 (0 findings).

Phase 1 success criteria all met:
- framework_selector: AI SaaS profile -> 5 frameworks (GDPR/AI Act binding + 27001/SOC2/42001 cert)
- cross_framework_mapper: 19 merged controls, 16 HIGH-confidence 27001+SOC2 pair themes, 51 atomic 27001 + 34 atomic SOC2 citations
- audit_simulator: 10 findings, 60% observation, 0% critical = healthy distribution
- evidence_pool: 15 artefacts, 100 total satisfactions, 11 high-leverage (>= 5 mappings)

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:48:33 +00:00
Claude
42304de423
feat(eu-ai-act): EU AI Act (2024/1689) compliance specialist for compliance teams
Stream A Phase 1 — Plugin 2 of 3 (compliance OS MVP).

Three stdlib Python tools at the Article level:
- ai_system_risk_classifier.py: Article 5 prohibitions check, then
  Article 6 + Annex III, then Article 6(3) carve-out test (overridden by
  profiling), then Article 50 transparency, then minimal-risk default.
  GPAI detection + Article 51 10^25 FLOPs systemic-risk threshold.
- conformity_assessment_planner.py: Article 43 Module A vs Module H routing
  (biometrics -> Module H by default); Annex IV 8-item technical
  documentation checklist with ISO 42001/27001 reuse map.
- ai_act_obligation_tracker.py: per-role (provider/deployer/importer/
  distributor/auth-rep) obligation matrix with Article 113 phasing
  deadlines (2 Feb 2025 / 2 Aug 2025 / 2 Aug 2026 / 2 Aug 2027).

Verified per Phase 1 success criteria: emotion-recognition-in-workplace
classified as prohibited (Article 5(1)(f)); CV-screening as high-risk
(Annex III §4); chatbot as limited-risk (Article 50); spam filter as
minimal-risk.

Four references each citing 5+ authoritative sources (the Regulation,
EDPB Opinion 28/2024, Commission Feb 2025 Guidelines, ENISA, IAPP Tracker,
CEN-CENELEC JTC 21, BSI, NIST AI 600-1):
- eu_ai_act_titles.md: Titles I-XII Article-by-Article walkthrough
- high_risk_systems_annex_iii.md: 8 categories + Article 6(3) decision tree
- gpai_obligations.md: Articles 51-55 + Annex XI-XIII + Code of Practice
- cross_framework_mapping_ai_act.md: AI Act <-> ISO 42001 <-> NIST AI RMF
  <-> GDPR cross-walk with Article 17(1) item-by-item mapping

Dual-published: standalone plugin (ra-qm-team/compliance-team-eu-ai-act/) +
mirror under ra-qm-team/skills/eu-ai-act-specialist/.

Karpathy gate: complexity_checker 100/100 (0 findings).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:35:41 +00:00
Claude
6537840af4
feat(iso42001): ISO/IEC 42001 AIMS specialist for compliance teams
Stream A Phase 1 — Plugin 1 of 3 (compliance OS MVP).

Three stdlib Python tools for internal AIMS audits:
- aims_gap_analyzer.py: scores Clauses 4-10 evidence (full/partial/missing)
  with severity weighting; outputs certification-readiness verdict
- ai_risk_register_builder.py: builds Clause 6.1 risk register per ISO 23894
  with 5x5 likelihood-impact matrix + Annex A control mapping + residual
  verdict per treatment option (modify/share/retain/avoid)
- aims_audit_scheduler.py: generates Clause 9.2 12-month audit plan with
  auditor independence checks + rolling 3-year coverage

Four references each citing 5+ authoritative sources:
- iso42001_clauses.md: Clauses 4-10 audit-evidence walkthrough
- aims_controls_annex_a.md: 38 Annex A controls (A.2-A.10) catalogue
- aims_implementation_guide.md: 3-year maturity model + ISO 27001/13485 reuse
- cross_framework_mapping_ai.md: 42001 <-> EU AI Act <-> NIST AI RMF <-> 23894
  <-> 38507 <-> 27001 control-level mapping

Dual-published: standalone plugin (ra-qm-team/compliance-team-iso42001/) +
mirror under ra-qm-team/skills/iso42001-specialist/.

Karpathy gate: complexity_checker 100/100 (0 findings).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
2026-05-13 17:28:15 +00:00
Alireza Rezvani
8606b45b05
Merge pull request #637 from alirezarezvani/dev
release: docs polish — surface 22 /cs:* commands in nav + clear all mkdocs INFO warnings
2026-05-13 16:30:07 +02:00
Alireza Rezvani
9493614e9d
Merge pull request #636 from alirezarezvani/feature/docs-polish
docs: polish nav (+22 /cs:* entries) + clear 33 mkdocs INFO warnings
2026-05-13 16:25:38 +02:00
Claude
bbe65c0936
docs: polish nav + clear 33 mkdocs INFO warnings
Two small polish tasks ahead of any future Pages deploy.

1. Add /cs:* command nav entries (22 new entries)

The 21 c-level-agents-* sub-skill pages now exist (since #632) but weren't
surfaced in mkdocs.yml sidebar nav. Added a "Founder-Mode Commands" nested
section under C-Level Advisory with:
  - c-level-agents index
  - 10 forcing-question reviews (/cs:cfo-review through /cs:vpe-review)
  - 5 strategic sprint pipeline commands (brief/boardroom/decide/execute/post-mortem)
  - 4 meta+safety commands (founder-mode/onboard/cross-eval/freeze)
  - /cs:office-hours

2. Clear 33 mkdocs INFO warnings

mkdocs build was emitting 33 INFO-level warnings during the docs deploy.
Pre-existing noise; not regressions. Three categories:

a) 27 unrecognized-link warnings: relative links like `[Skills](skills/)`
   that mkdocs flags because the path doesn't end in .md. Fix: added
   explicit `index.md` suffix in 3 manual doc files.
     - docs/index.md: 15 links
     - docs/skills/index.md: 11 links
     - docs/custom-gpts.md: 1 link

b) 2 anchor warnings in scrum-master TOC: links pointed to
   `#analysis-tools--usage` and `#key-metrics--targets` (double hyphen
   from ampersand) but mkdocs Material's slugify produces single-hyphen
   slugs. Fix: changed to `#analysis-tools-usage` and `#key-metrics-targets`.

c) 4 anchor warnings in senior-computer-vision + senior-data-engineer TOCs:
   links pointed to non-existent sections.
   - senior-computer-vision: `#common-commands` TOC entry — no such heading
     anywhere; removed the entry.
   - senior-data-engineer: 3 sub-bullets pointing to `#workflow-1-...`,
     `#workflow-2-...`, `#workflow-3-...` — no such headings (only a
     parent `## Workflows`); removed the sub-bullets.

Verification:
- mkdocs build now emits 0 INFO warnings
- karpathy diff_surgeon: 0 findings on staged diff
- All 22 new nav entries verified to point to existing HTML pages
- generate-docs.py re-run picked up the upstream SKILL.md fixes; docs/skills/
  now matches sources

10 files changed, +54/-39. After the next dev->main release, the Pages
deploy will have:
- Cleaner build output (no INFO noise)
- Fully discoverable /cs:* command pages in the sidebar nav

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 14:14:45 +00:00
Alireza Rezvani
f3d4c8aaa6
Merge pull request #635 from alirezarezvani/dev
release: v2.5.7 hotfix 2 — recover 79 dropped sub-skill pages
2026-05-13 16:00:51 +02:00
Alireza Rezvani
0cafb80e8e
Merge pull request #632 from alirezarezvani/feature/docs-fix-dropped-skills
fix(docs): render orphan sub-skills (recover 79 missing skill pages)
2026-05-13 15:40:20 +02:00
Claude
6524d93478
fix(docs): render orphan sub-skills (recover 79 missing skill pages)
generate-docs.py had a longstanding bug: the rendering loop only iterated
top-level skills and only rendered their direct children. Sub-skills whose
parent is a plugin folder (not a top-level skill at <domain>/skills/<name>/)
were silently dropped.

Affected plugins (standalone-only, no bundled mirror at <domain>/skills/):
- executive-mentor (1 index + 5 sub-skills)
- agenthub (1 index + 7 sub-skills)
- autoresearch-agent (1 index + 5 sub-skills)
- playwright-pro (1 index + 9 sub-skills)
- self-improving-agent (1 index + 5 sub-skills)
- c-level-agents (1 index + 17 sub-skills — the new /cs:* commands)
- llm-wiki (1 index + sub-skills)
- behuman, code-tour, demo-video, helm-chart-builder, karpathy-coder,
  llm-cost-optimizer, prompt-governance, statistical-analyst, terraform-patterns,
  data-quality-auditor, docker-development (single-skill plugins)

Total: 79 sub-skills + 12 plugin-index skills = 91 pages were being dropped.
(Some plugins like behuman are single-skill so only their index is dropped.)

The bug: rendering loop at line 414 only handled `for skill in top_level`,
then for each top-level found `children = [s for s in sub_skills if
s["parent"] == skill["name"]]`. Plugins where the SKILL.md lives only at
<plugin>/skills/<plugin>/SKILL.md don't appear in top_level (their detection
puts them in sub_skills with parent=themselves), so their children were
orphaned.

The fix: after the existing top-level loop, render orphan sub-skills grouped
by their plugin parent. Index sub-skill (named same as parent) renders as
<parent>.md; other children render as <parent>-<child>.md. This matches the
URL convention already in use (e.g., executive-mentor-challenge.md), so
existing SEO equity is preserved.

Result: skill pages generated 193 → 272 (+79 recovered). Total docs pages
280 → 359. mkdocs build succeeds.

Verified:
- All 12 previously-dropped plugins render their index page
- All 79 previously-dropped sub-skills render their detail pages
- URL convention preserved (executive-mentor-challenge.md, agenthub-board.md,
  playwright-pro-coverage.md, etc.)
- karpathy diff_surgeon: 0 findings

After dev → main release: GitHub Pages redeploys with the recovered 79 pages.
The docs site finally has 1:1 correspondence between SKILL.md files in the
repo and pages on the site.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 12:49:00 +00:00
Alireza Rezvani
0b5902ecfc
Merge pull request #631 from alirezarezvani/dev
release: v2.5.7 hotfix — fix 13 broken cs-* nav 404s + recover 12 plugin-internal agent pages
2026-05-13 12:10:31 +02:00
Alireza Rezvani
8c6bac53fd
Merge pull request #630 from alirezarezvani/feature/docs-hotfix-plugin-agents
fix(docs): walk plugin-internal agents folders to fix 13 broken cs-* nav 404s
2026-05-13 12:01:29 +02:00