From 02c04e3d32a2c16e0fa5e526d2d522ae3f7edc62 Mon Sep 17 00:00:00 2001 From: Ben Fairless Date: Sat, 1 Aug 2026 10:33:23 +0800 Subject: [PATCH] fix(frontmatter): repair 14 unloadable YAML blocks Twelve files had frontmatter that yaml.safe_load rejects, all from the same cause: an unquoted plain scalar containing ": " inside description. Claude Code responds by loading the body with empty metadata, so the skill keeps working via /name but has no description for the model to match against, and the seven affected agents (where name and description are required) may not load at all. Eleven are fixed by quoting the existing scalar, leaving the text byte-identical. design-system carries both ' and " so quoting would defeat the repo's regex extractors in generate-docs.py and sync-codex-skills.py; its one colon-space is reworded instead ("Precedence:" -> "Precedence is"). Two agents had no frontmatter at all and were being listed with a placeholder description; both now declare name and description. tools is deliberately omitted so they keep inheriting the full set, as before. Assisted-by: Claude Code:claude-opus-5 --- .claude/commands/focused-fix.md | 2 +- business-operations/commands/cs-bizops.md | 2 +- c-level-advisor/arquiteto-de-empresa/agents/cs-arquiteto.md | 2 +- c-level-advisor/executive-mentor/agents/devils-advocate.md | 5 +++++ commercial/commands/cs-commercial.md | 2 +- compliance-os/agents/cs-ai-act-compliance.md | 2 +- compliance-os/agents/cs-aims-iso42001.md | 2 +- compliance-os/agents/cs-fda-qsr-auditor.md | 2 +- engineering/autoresearch-agent/agents/experiment-runner.md | 5 +++++ markdown-html/skills/design-system/SKILL.md | 2 +- markdown-html/skills/md-slides/SKILL.md | 2 +- productivity/andreessen/agents/cs-andreessen.md | 2 +- productivity/deep-work/agents/cs-deep-work.md | 2 +- research/notebooklm/agents/cs-notebooklm.md | 2 +- 14 files changed, 22 insertions(+), 12 deletions(-) diff --git a/.claude/commands/focused-fix.md b/.claude/commands/focused-fix.md index 0f15a49c..db1b0614 100644 --- a/.claude/commands/focused-fix.md +++ b/.claude/commands/focused-fix.md @@ -1,5 +1,5 @@ --- -description: Deep-dive feature repair — systematically fix an entire feature/module. Usage: /focused-fix +description: "Deep-dive feature repair — systematically fix an entire feature/module. Usage: /focused-fix " --- Systematically repair the feature/module at `$ARGUMENTS` using the focused-fix 5-phase protocol. diff --git a/business-operations/commands/cs-bizops.md b/business-operations/commands/cs-bizops.md index 23b9fe57..6a8d7272 100644 --- a/business-operations/commands/cs-bizops.md +++ b/business-operations/commands/cs-bizops.md @@ -1,5 +1,5 @@ --- -description: Top-level Business Operations router. Routes the inquiry to one of six BizOps sub-skills (process, vendor, capacity, comms, knowledge, procurement) and returns a digest. Invokes the business-operations-skills orchestrator (context: fork). +description: "Top-level Business Operations router. Routes the inquiry to one of six BizOps sub-skills (process, vendor, capacity, comms, knowledge, procurement) and returns a digest. Invokes the business-operations-skills orchestrator (context: fork)." argument-hint: "" --- diff --git a/c-level-advisor/arquiteto-de-empresa/agents/cs-arquiteto.md b/c-level-advisor/arquiteto-de-empresa/agents/cs-arquiteto.md index cb7c9eb1..cf672cb8 100644 --- a/c-level-advisor/arquiteto-de-empresa/agents/cs-arquiteto.md +++ b/c-level-advisor/arquiteto-de-empresa/agents/cs-arquiteto.md @@ -1,6 +1,6 @@ --- name: cs-arquiteto -description: Company Architect — a senior chief of staff who builds a business from scratch as an OKF (Open Knowledge Format) bundle: a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved index.md/log.md. Guides the founder through a 12-phase interview (foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, governance), one phase at a time, at most 3-5 questions per block, confirming before generating each concept. Trigger when the user wants to create, structure, or document an entire company as folders and markdown files, or mentions company as code, company knowledge base for AI, OKF, or knowledge bundle. Works in English. Never dumps the company all at once — it interviews, validates, and builds phase by phase. +description: "Company Architect — a senior chief of staff who builds a business from scratch as an OKF (Open Knowledge Format) bundle: a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved index.md/log.md. Guides the founder through a 12-phase interview (foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, governance), one phase at a time, at most 3-5 questions per block, confirming before generating each concept. Trigger when the user wants to create, structure, or document an entire company as folders and markdown files, or mentions company as code, company knowledge base for AI, OKF, or knowledge bundle. Works in English. Never dumps the company all at once — it interviews, validates, and builds phase by phase." skills: c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa domain: c-level model: opus diff --git a/c-level-advisor/executive-mentor/agents/devils-advocate.md b/c-level-advisor/executive-mentor/agents/devils-advocate.md index 8b7fe872..5379ee36 100644 --- a/c-level-advisor/executive-mentor/agents/devils-advocate.md +++ b/c-level-advisor/executive-mentor/agents/devils-advocate.md @@ -1,3 +1,8 @@ +--- +name: devils-advocate +description: "Adversarial reviewer for executive plans, proposals, and decisions. Returns exactly three specific concerns, each severity-rated CRITICAL / HIGH / MEDIUM, with the evidence that would confirm or kill it. Use before committing resources to a plan, before a board or investor presentation, or when feedback so far has been one-sidedly positive. Not a code reviewer." +--- + # Devil's Advocate Agent **Role:** Adversarial thinker. Finds what's wrong before others do. diff --git a/commercial/commands/cs-commercial.md b/commercial/commands/cs-commercial.md index c31e0fdc..ef494855 100644 --- a/commercial/commands/cs-commercial.md +++ b/commercial/commands/cs-commercial.md @@ -1,5 +1,5 @@ --- -description: Top-level Commercial router. Routes the inquiry to one of seven Commercial sub-skills (pricing, deal, partner, channel, policy, RFP, forecast) and returns a digest. Invokes the commercial-skills orchestrator (context: fork). +description: "Top-level Commercial router. Routes the inquiry to one of seven Commercial sub-skills (pricing, deal, partner, channel, policy, RFP, forecast) and returns a digest. Invokes the commercial-skills orchestrator (context: fork)." argument-hint: "" --- diff --git a/compliance-os/agents/cs-ai-act-compliance.md b/compliance-os/agents/cs-ai-act-compliance.md index 6b0634a3..672856d1 100644 --- a/compliance-os/agents/cs-ai-act-compliance.md +++ b/compliance-os/agents/cs-ai-act-compliance.md @@ -1,6 +1,6 @@ --- name: cs-ai-act-compliance -description: EU AI Act (Regulation (EU) 2024/1689) Article-cited compliance operator. Three decisions: AI system risk tier (Article 5 / 6+ Annex III / 50 / minimal), conformity assessment routing (Article 43 Module A vs H + Annex IV docs), per-role obligation matrix (provider/deployer/importer/distributor + GPAI). NOT executive AI strategy (see cs-caio-advisor). NOT a legal substitute (engage counsel for novel cases). +description: "EU AI Act (Regulation (EU) 2024/1689) Article-cited compliance operator. Three decisions: AI system risk tier (Article 5 / 6+ Annex III / 50 / minimal), conformity assessment routing (Article 43 Module A vs H + Annex IV docs), per-role obligation matrix (provider/deployer/importer/distributor + GPAI). NOT executive AI strategy (see cs-caio-advisor). NOT a legal substitute (engage counsel for novel cases)." skills: ra-qm-team/skills/eu-ai-act-specialist domain: compliance-os model: opus diff --git a/compliance-os/agents/cs-aims-iso42001.md b/compliance-os/agents/cs-aims-iso42001.md index 0bec3f4f..880b42b3 100644 --- a/compliance-os/agents/cs-aims-iso42001.md +++ b/compliance-os/agents/cs-aims-iso42001.md @@ -1,6 +1,6 @@ --- name: cs-aims-iso42001 -description: ISO/IEC 42001:2023 AI Management System (AIMS) implementation + internal audit operator. Three decisions: AIMS gaps against Clauses 4-10, AI risk register per Annex A + ISO 23894, Clause 9.2 internal audit plan. NOT executive AI strategy (see cs-caio-advisor). NOT EU AI Act conformity (see cs-ai-act-compliance). +description: "ISO/IEC 42001:2023 AI Management System (AIMS) implementation + internal audit operator. Three decisions: AIMS gaps against Clauses 4-10, AI risk register per Annex A + ISO 23894, Clause 9.2 internal audit plan. NOT executive AI strategy (see cs-caio-advisor). NOT EU AI Act conformity (see cs-ai-act-compliance)." skills: ra-qm-team/skills/iso42001-specialist domain: compliance-os model: opus diff --git a/compliance-os/agents/cs-fda-qsr-auditor.md b/compliance-os/agents/cs-fda-qsr-auditor.md index 3bcaa986..ee9e1f38 100644 --- a/compliance-os/agents/cs-fda-qsr-auditor.md +++ b/compliance-os/agents/cs-fda-qsr-auditor.md @@ -1,6 +1,6 @@ --- name: cs-fda-qsr-auditor -description: FDA 21 CFR 820 (QSR / QMSR) auditor persona. Substantially harmonized with ISO 13485 post-Feb 2026 via FDA Final Rule incorporating ISO 13485 by reference. Adds FDA-specific overlays: labeling (21 CFR 801), complaint handling (21 CFR 820.198), MDR reporting (21 CFR 803), 510(k) / PMA submissions. NOT FDA submission strategy (route to fda-consultant-specialist for that). +description: "FDA 21 CFR 820 (QSR / QMSR) auditor persona. Substantially harmonized with ISO 13485 post-Feb 2026 via FDA Final Rule incorporating ISO 13485 by reference. Adds FDA-specific overlays: labeling (21 CFR 801), complaint handling (21 CFR 820.198), MDR reporting (21 CFR 803), 510(k) / PMA submissions. NOT FDA submission strategy (route to fda-consultant-specialist for that)." skills: ra-qm-team/skills/fda-consultant-specialist domain: compliance-os model: opus diff --git a/engineering/autoresearch-agent/agents/experiment-runner.md b/engineering/autoresearch-agent/agents/experiment-runner.md index 120d81eb..92056286 100644 --- a/engineering/autoresearch-agent/agents/experiment-runner.md +++ b/engineering/autoresearch-agent/agents/experiment-runner.md @@ -1,3 +1,8 @@ +--- +name: experiment-runner +description: "Runs one iteration of an autoresearch experiment loop. Reads experiment state from .autoresearch/{domain}/{name}/, makes exactly ONE change to the target file, commits it, evaluates via run_experiment.py, and reports KEEP / DISCARD / CRASH. Spawned per iteration by /ar:run and /ar:loop. Never modifies the evaluator. Not for general refactoring or multi-change edits." +--- + # Experiment Runner Agent You are an autonomous experimenter. Your job is to optimize a target file by a measurable metric, one change at a time. diff --git a/markdown-html/skills/design-system/SKILL.md b/markdown-html/skills/design-system/SKILL.md index 16b54cad..d52846ff 100644 --- a/markdown-html/skills/design-system/SKILL.md +++ b/markdown-html/skills/design-system/SKILL.md @@ -1,6 +1,6 @@ --- name: design-system -description: Captures the user's brand identity once via a 10-question onboarding wizard (primary/accent HEX + heading + body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company), validates body-text and link contrast against WCAG 2.2 AA, derives 12 CSS custom properties in HSL space, and stores the result for every markdown-html converter to consume. Use before any markdown-html conversion. Triggers on first-run onboarding ("set up the brand", "configure markdown-html", "run onboarding"), on explicit reset ("reset the design system", "re-onboard"), and is checked by every converter via config_loader.py before rendering. Refuses to save if body-text contrast fails AA 4.5:1 or the output dir isn't writable. Precedence: project (./.markdown-html/) > global (~/.config/markdown-html/) > built-in defaults; MARKDOWN_HTML_NO_CONFIG=1 bypasses. +description: Captures the user's brand identity once via a 10-question onboarding wizard (primary/accent HEX + heading + body Google Fonts + design style editorial/technical/minimal/playful + default output directory + syntax theme + TOC behavior + optional logo/company), validates body-text and link contrast against WCAG 2.2 AA, derives 12 CSS custom properties in HSL space, and stores the result for every markdown-html converter to consume. Use before any markdown-html conversion. Triggers on first-run onboarding ("set up the brand", "configure markdown-html", "run onboarding"), on explicit reset ("reset the design system", "re-onboard"), and is checked by every converter via config_loader.py before rendering. Refuses to save if body-text contrast fails AA 4.5:1 or the output dir isn't writable. Precedence is project (./.markdown-html/) > global (~/.config/markdown-html/) > built-in defaults; MARKDOWN_HTML_NO_CONFIG=1 bypasses. version: 2.10.0 author: Alireza Rezvani license: MIT diff --git a/markdown-html/skills/md-slides/SKILL.md b/markdown-html/skills/md-slides/SKILL.md index 2b762aa8..a31560a0 100644 --- a/markdown-html/skills/md-slides/SKILL.md +++ b/markdown-html/skills/md-slides/SKILL.md @@ -1,6 +1,6 @@ --- name: md-slides -description: Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs:md-slides. Reuses md-document's markdown parser for slide-body rendering and reads design-system tokens via config_loader.py. Refuses if input has no clear slide boundaries, produces a 1-slide deck, or `--strict-notes` is on with < 50% notes coverage. Use after orchestrator routing. +description: "Converts a markdown deck (slides separated by `---` HR boundaries or by `# ` H1 headings, with optional `` presenter notes blocks) into a single-file HTML presentation with arrow-key / space / PgDn / PgUp / Home / End / P / Esc keyboard navigation, presenter mode (split view with current slide + speaker notes + clock + next-slide preview), URL-hash deep linking, and `@media print` page-per-slide for PDF export. Triggers when the markdown-html-orchestrator classifies an input as SLIDES, or when invoked directly via /cs:md-slides. Reuses md-document's markdown parser for slide-body rendering and reads design-system tokens via config_loader.py. Refuses if input has no clear slide boundaries, produces a 1-slide deck, or `--strict-notes` is on with < 50% notes coverage. Use after orchestrator routing." version: 2.10.3 author: Alireza Rezvani license: MIT diff --git a/productivity/andreessen/agents/cs-andreessen.md b/productivity/andreessen/agents/cs-andreessen.md index bd9b2fab..03e1d2cf 100644 --- a/productivity/andreessen/agents/cs-andreessen.md +++ b/productivity/andreessen/agents/cs-andreessen.md @@ -1,6 +1,6 @@ --- name: cs-andreessen -description: Marc Andreessen-mode operator. Runs on a fixed anti-sycophancy operating prompt — leads with the strongest counterargument, never validates premises or praises the question, no disclaimers, no morals lectures, explicit confidence levels (high/moderate/low/unknown), never apologizes for disagreeing, never capitulates without new evidence. Pressure-tests ventures/ideas/features/career bets through Andreessen's documented frameworks: market dominates team and product, product/market fit is the only milestone that matters, bias to build. Issues hard verdicts (BUILD-POUR-FUEL / MARKET-FIRST-DERISK / KILL-OR-REPICK-MARKET) backed by deterministic tools. Also runs the 3x5-card + Anti-Todo daily routine. Refuses to soften a dead-market verdict. Refuses to cite a quote without a confidence level. +description: "Marc Andreessen-mode operator. Runs on a fixed anti-sycophancy operating prompt — leads with the strongest counterargument, never validates premises or praises the question, no disclaimers, no morals lectures, explicit confidence levels (high/moderate/low/unknown), never apologizes for disagreeing, never capitulates without new evidence. Pressure-tests ventures/ideas/features/career bets through Andreessen's documented frameworks: market dominates team and product, product/market fit is the only milestone that matters, bias to build. Issues hard verdicts (BUILD-POUR-FUEL / MARKET-FIRST-DERISK / KILL-OR-REPICK-MARKET) backed by deterministic tools. Also runs the 3x5-card + Anti-Todo daily routine. Refuses to soften a dead-market verdict. Refuses to cite a quote without a confidence level." skills: productivity/andreessen/skills/andreessen domain: productivity model: opus diff --git a/productivity/deep-work/agents/cs-deep-work.md b/productivity/deep-work/agents/cs-deep-work.md index 97533fab..cd6d1c50 100644 --- a/productivity/deep-work/agents/cs-deep-work.md +++ b/productivity/deep-work/agents/cs-deep-work.md @@ -1,6 +1,6 @@ --- name: cs-deep-work -description: Plans a deep work day the Cal Newport way — audits a task list deep vs shallow against a 30-50% shallow budget, builds an energy-first time-blocked schedule (deep blocks of at least 90 minutes in the earliest hours, a hard 4-hour deep ceiling, shallow work batched into at most two windows, 10-minute buffers, an immovable hard stop), logs focus sessions against a weekly target, and closes the day with a shutdown ritual. Respects the scripts' exit-2 refusals: deep demand past the cap and overflow past the hard stop are named and deferred, never squeezed in. Use to plan or re-plan a focused day, cut shallow work, or track deep-hours streaks. +description: "Plans a deep work day the Cal Newport way — audits a task list deep vs shallow against a 30-50% shallow budget, builds an energy-first time-blocked schedule (deep blocks of at least 90 minutes in the earliest hours, a hard 4-hour deep ceiling, shallow work batched into at most two windows, 10-minute buffers, an immovable hard stop), logs focus sessions against a weekly target, and closes the day with a shutdown ritual. Respects the scripts' exit-2 refusals: deep demand past the cap and overflow past the hard stop are named and deferred, never squeezed in. Use to plan or re-plan a focused day, cut shallow work, or track deep-hours streaks." skills: productivity/deep-work/skills/deep-work domain: productivity model: opus diff --git a/research/notebooklm/agents/cs-notebooklm.md b/research/notebooklm/agents/cs-notebooklm.md index 0b8542f1..b5b29e6f 100644 --- a/research/notebooklm/agents/cs-notebooklm.md +++ b/research/notebooklm/agents/cs-notebooklm.md @@ -1,6 +1,6 @@ --- name: cs-notebooklm -description: NotebookLM browser-automation persona. Walks 2-4 forcing intake questions (Q1 action: read / add source / Studio output / create new; Q2-Q4 branch per action). Refuses to start without action commitment. Refuses to handle login flows automatically. Refuses to wait synchronously for Studio generations (fire-and-notify). Always opens Studio customization menu and writes detailed custom prompt (default prompts produce mediocre output). Screenshot-first discipline. find()-before-click. Fails fast when browser automation unavailable. +description: "NotebookLM browser-automation persona. Walks 2-4 forcing intake questions (Q1 action: read / add source / Studio output / create new; Q2-Q4 branch per action). Refuses to start without action commitment. Refuses to handle login flows automatically. Refuses to wait synchronously for Studio generations (fire-and-notify). Always opens Studio customization menu and writes detailed custom prompt (default prompts produce mediocre output). Screenshot-first discipline. find()-before-click. Fails fast when browser automation unavailable." skills: research/notebooklm/skills/notebooklm domain: research model: opus