docs: import ADR-0006/0007/0008 and reconcile skill lists#8
Draft
cooper (czxtm) wants to merge 2 commits into
Draft
docs: import ADR-0006/0007/0008 and reconcile skill lists#8cooper (czxtm) wants to merge 2 commits into
cooper (czxtm) wants to merge 2 commits into
Conversation
…skills Two accepted ADRs (0006 README minimum standard, 0007 type-checked SQL) existed in darkmatter/skills/docs/adr but were never imported here - add them to CLAUDE.md, AGENTS.md, and copilot-instructions.md. Also reconcile the skill catalogs in all three files against the actual skills/<name>/ directories in darkmatter/skills: remove ~14 phantom skills (coding-standards, systematic-debugging, writing-plans, executing-plans, subagent-driven-development, dispatching-parallel-agents, frontend-design, browser-use, caveman, caveman-review, compress, neon-postgres, hl-funding-analysis, verification-before-completion) that don't exist as skill directories, and add ~14 real skills that were missing (diagnose, choose-dev-entrypoints, grill-me, grill-with-docs, handoff, improve-codebase-architecture, prototype, rust-best-practices, shadcn-registry-first, tdd, triage, ui-component-architecture, run-ui-registry-variations, zoom-out). AGENTS.md is the file OpenAI Codex CLI reads by convention, and copilot-instructions.md is explicitly titled for Copilot & Codex, so this is the concrete "Codex instructions" update alongside the Claude Code (CLAUDE.md) one.
…d bullet darkmatter/skills docs/adr now has a filed ADR-0008 (decouple telemetry concerns) backported from the obsidian wiki's already-accepted write-up. Point at it instead of the informal "OTel-only observability" heading.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Imports what's changed in
darkmatter/skillssince the last sync (c3b97da) into the three org-level agent instruction files.darkmatter/skills/docs/adrbut were never imported here.darkmatter/skills(see [darkmatter/skills#PR]) — it had only been written up informally as an unnumbered "OTel-only observability" bullet in these files. Now points at the real ADR.CLAUDE.md,AGENTS.md, and.github/copilot-instructions.mdreferenced ~14 skills that don't exist asskills/<name>/directories indarkmatter/skills(coding-standards,systematic-debugging,writing-plans,executing-plans,subagent-driven-development,dispatching-parallel-agents,frontend-design,browser-use,caveman,caveman-review,compress,neon-postgres,hl-funding-analysis,verification-before-completion) and were missing ~14 real skills (diagnose,choose-dev-entrypoints,grill-me,grill-with-docs,handoff,improve-codebase-architecture,prototype,rust-best-practices,shadcn-registry-first,tdd,triage,ui-component-architecture,run-ui-registry-variations,zoom-out).AGENTS.mdis the file OpenAI Codex CLI reads by convention, and.github/copilot-instructions.mdis explicitly titled for Copilot & Codex — updating both is the concrete "Codex instructions" half of this change, alongsideCLAUDE.mdfor Claude Code.Changes
CLAUDE.md,AGENTS.md,.github/copilot-instructions.md: add ADR-0006/0007/0008 rows; replace the skill catalog tables with the actual current skill set, categorized; add a note pointing atdocs/catalog.md's "Known gaps" section for anyone tempted to invoke a phantom skill by name.Related
darkmatter/skillsfiling ADR-0008 and reconciling its own catalog (companion PR in that repo) — not a hard dependency, this PR's links resolve either way since GitHub renders them regardless of merge order.Test plan
ls skills/in a local checkout ofdarkmatter/skillsto confirm every listed skill has a matching directory and no real skill was dropped.Generated by Claude Code