{ "_ai_door": { "see": "https://miscsubjects.com/start", "note": "Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome." }, "_self": { "what": "Public skill registry of miscsubjects.com — the loop that stops repeated failures, machine-readable.", "human_index": "/skills", "governed_by": "/a/skill-law", "how_to_use": "GET /api/skills/ for the object, /api/skills//skill for raw SKILL.md, /api/skills//bundle?format=zip for the folder." }, "generated_at": "2026-08-12T00:49:17.941Z", "count": 23, "private_unlisted": 29, "laws": [ { "slug": "design-law", "human": "/a/design-law", "json": "/api/articles/design-law", "skill": "/api/articles/design-law/skill" }, { "slug": "writing-law", "human": "/a/writing-law", "json": "/api/articles/writing-law", "skill": "/api/articles/writing-law/skill" }, { "slug": "skill-law", "human": "/a/skill-law", "json": "/api/articles/skill-law", "skill": "/api/articles/skill-law/skill" } ], "skills": [ { "name": "coding-law", "family": "code discipline", "description": "Use before the first edit of any file under functions/, scripts/, migrations/, workers/, apps-script/, .claude/skills/, .agents/skills/, schema.sql or wrangler.toml — and again immediately before every git commit. Take a hash when work starts, submit a hash when work commits. Prevents two agents from silently overwriting each other with individually valid commits.", "license": null, "source": null, "prevents": [ { "date": "2026-08-05", "failure": "Two agents read the same file at the same version, both edited from it, and the second commit erased the first agent's work. Each commit was individually valid, so nothing in git showed the loss. The file-claim system recorded who was working where but never what text they were working from." } ], "human": "/skills/coding-law", "json": "/api/skills/coding-law", "skill": "/api/skills/coding-law/skill", "folder_zip": "/api/skills/coding-law/bundle?format=zip" }, { "name": "dispatching-parallel-agents", "family": "code discipline", "description": "Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "2026-07", "failure": "Concurrent sessions edited the same shared files and overwrote each other's work; the write-law claim system exists because of it." } ], "human": "/skills/dispatching-parallel-agents", "json": "/api/skills/dispatching-parallel-agents", "skill": "/api/skills/dispatching-parallel-agents/skill", "folder_zip": "/api/skills/dispatching-parallel-agents/bundle?format=zip" }, { "name": "executing-plans", "family": "code discipline", "description": "Use when you have a written implementation plan to execute in a separate session with review checkpoints", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Concurred plans stalled mid-phase awaiting a go-ahead nobody asked for, instead of executing through every phase." } ], "human": "/skills/executing-plans", "json": "/api/skills/executing-plans", "skill": "/api/skills/executing-plans/skill", "folder_zip": "/api/skills/executing-plans/bundle?format=zip" }, { "name": "finishing-a-development-branch", "family": "code discipline", "description": "Use when implementation is complete, all tests pass, and you need to decide how to integrate the work", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "2026-07-22", "failure": "Completed work saved on a side line does not exist for the build until folded into the live line; stranded finished work re-alarmed for weeks." } ], "human": "/skills/finishing-a-development-branch", "json": "/api/skills/finishing-a-development-branch", "skill": "/api/skills/finishing-a-development-branch/skill", "folder_zip": "/api/skills/finishing-a-development-branch/bundle?format=zip" }, { "name": "grill-me", "family": "code discipline", "description": "A relentless interview to sharpen a plan or design.", "license": "MIT", "source": "mattpocock/skills", "prevents": [ { "date": "recurring", "failure": "Requirements accepted at face value; plan holes discovered after the build instead of before it." } ], "human": "/skills/grill-me", "json": "/api/skills/grill-me", "skill": "/api/skills/grill-me/skill", "folder_zip": "/api/skills/grill-me/bundle?format=zip" }, { "name": "receiving-code-review", "family": "code discipline", "description": "Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Review feedback implemented blindly or performatively agreed with, instead of verified against the code." } ], "human": "/skills/receiving-code-review", "json": "/api/skills/receiving-code-review", "skill": "/api/skills/receiving-code-review/skill", "folder_zip": "/api/skills/receiving-code-review/bundle?format=zip" }, { "name": "requesting-code-review", "family": "code discipline", "description": "Use when completing tasks, implementing major features, or before merging to verify work meets requirements", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Work merged without an independent review pass; defects found by the owner instead of a reviewer." } ], "human": "/skills/requesting-code-review", "json": "/api/skills/requesting-code-review", "skill": "/api/skills/requesting-code-review/skill", "folder_zip": "/api/skills/requesting-code-review/bundle?format=zip" }, { "name": "systematic-debugging", "family": "code discipline", "description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "2026-07-23", "failure": "A source hash-chain broke (broken_at:0) and was patched by guesswork before the root cause — claims growing a source's body without rechaining — was isolated." } ], "human": "/skills/systematic-debugging", "json": "/api/skills/systematic-debugging", "skill": "/api/skills/systematic-debugging/skill", "folder_zip": "/api/skills/systematic-debugging/bundle?format=zip" }, { "name": "test-driven-development", "family": "code discipline", "description": "Use when implementing any feature or bugfix, before writing implementation code", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Fixes shipped without a failing test first; the same regressions were re-fixed in later sessions." } ], "human": "/skills/test-driven-development", "json": "/api/skills/test-driven-development", "skill": "/api/skills/test-driven-development/skill", "folder_zip": "/api/skills/test-driven-development/bundle?format=zip" }, { "name": "using-git-worktrees", "family": "code discipline", "description": "Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "2026-07-22", "failure": "Seventeen changes stranded on side lines over two months had to be forensically dispositioned; isolated worktrees with a fold-or-disposition exit would have prevented every one." } ], "human": "/skills/using-git-worktrees", "json": "/api/skills/using-git-worktrees", "skill": "/api/skills/using-git-worktrees/skill", "folder_zip": "/api/skills/using-git-worktrees/bundle?format=zip" }, { "name": "verification-before-completion", "family": "code discipline", "description": "Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "2026-07-23", "failure": "A page shipped as a blank render error and was declared done; the failure surfaced only when the rendered page was finally opened." } ], "human": "/skills/verification-before-completion", "json": "/api/skills/verification-before-completion", "skill": "/api/skills/verification-before-completion/skill", "folder_zip": "/api/skills/verification-before-completion/bundle?format=zip" }, { "name": "webapp-testing", "family": "code discipline", "description": "Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.", "license": "Apache-2.0", "source": "anthropics/skills", "prevents": [ { "date": "recurring", "failure": "Features declared working from API responses or source reads while the rendered page was broken; the build's rule that only the rendered view counts came from this failure class." } ], "human": "/skills/webapp-testing", "json": "/api/skills/webapp-testing", "skill": "/api/skills/webapp-testing/skill", "folder_zip": "/api/skills/webapp-testing/bundle?format=zip" }, { "name": "writing-plans", "family": "code discipline", "description": "Use when you have a spec or requirements for a multi-step task, before touching code", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Multi-step work delivered out of prerequisite order — a value referenced before the step that produces it." } ], "human": "/skills/writing-plans", "json": "/api/skills/writing-plans", "skill": "/api/skills/writing-plans/skill", "folder_zip": "/api/skills/writing-plans/bundle?format=zip" }, { "name": "seo-distribution-law", "family": "distribution", "description": "Use when writing, reviewing, or shipping anything that affects how this site is found, indexed, shared, or syndicated — SEO heads, sitemaps, feeds, share surfaces, network posting, or the self-score. The site's perception of search and distribution best practices lives here, is enforced live at /api/seo/score, and is open to critique; never assert a practice from memory when this file and that endpoint disagree.", "license": null, "source": null, "prevents": [ { "date": "2026-08-06", "failure": "The IndexNow key file had been served since June with no caller — dead plumbing invisible until a full audit. The homepage carried no Open Graph, Twitter card, or canonical while every article did. The site's perception of distribution best practices lived nowhere, so it could not be scored, audited, or critiqued." } ], "human": "/skills/seo-distribution-law", "json": "/api/skills/seo-distribution-law", "skill": "/api/skills/seo-distribution-law/skill", "folder_zip": "/api/skills/seo-distribution-law/bundle?format=zip" }, { "name": "agent-work-law", "family": "the loop", "description": "Use at the start of every session operating miscsubjects.com, and whenever deciding what to work on, whether work is finished, or what to do about a failure. The infrastructure is the authority; this skill tells you where it lives and how to obey it.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-08-04", "failure": "The project's operating intelligence lived in CLAUDE.md, STATE.md, AGENTS.md and in whichever Claude session was open: the rules, what remained unfinished, assignment, dependency order, and the decision that work was done. A fresh agent could not enter the project, a different model could not continue it, and every owner correction was answered with another line in a file no future agent would read. Work is now a leased task object whose completion is decided by acceptance tests the infrastructure runs." } ], "human": "/skills/agent-work-law", "json": "/api/skills/agent-work-law", "skill": "/api/skills/agent-work-law/skill", "folder_zip": "/api/skills/agent-work-law/bundle?format=zip" }, { "name": "article-editing", "family": "the loop", "description": "Use when creating, editing, sourcing, illustrating, exporting, or deleting any article on miscsubjects.com — from the admin studio, curl, a coding agent, a Cloudflare Gateway model, or Google Sheets. One REST contract for all of them.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-07-29", "failure": "Models asked to write or edit one article burned most of their turn discovering tools, repairing formats, and choosing between competing write paths; the owner ordered one documented REST contract for every client — studio, curl, agents, Gateway models, Sheets." } ], "human": "/skills/article-editing", "json": "/api/skills/article-editing", "skill": "/api/skills/article-editing/skill", "folder_zip": "/api/skills/article-editing/bundle?format=zip" }, { "name": "self-promotion", "family": "the loop", "description": "The build's standing procedure for promoting itself — deciding whether, whom, when, on which channel, and with which artifact to make contact whenever something ships or a reply lands. Governs the allocation, not the copy (outreach-law governs the copy). Load whenever a new article, capability, receipt, resolved defect, or inbound reply changes what the build has to show someone, or when planning any post, email, or paid spend about the build itself.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-07-06", "failure": "Eleven external emails were sent by the outreach machinery before the confirmation gate existed, and the single-send path recorded no tracking rows — activity a promotion system took that its own records understated. Contact decisions are now computed, recorded on the ledger before the send, and gated on owner review." }, { "date": "2026-07-25", "failure": "A personalisation rule strict enough to ban every available observation left one legal opener, and 121 drafts converged on the same sentence under the same four-word subject — interchangeable mail produced by ever-stricter rules. Rule changes now version to outreach_rule_versions and re-run the shape clustering to prove no collapse." } ], "human": "/skills/self-promotion", "json": "/api/skills/self-promotion", "skill": "/api/skills/self-promotion/skill", "folder_zip": "/api/skills/self-promotion/bundle?format=zip" }, { "name": "shared-failure-to-skill", "family": "the loop", "description": "Use when the owner reports a recurring failure, repeated fix, or systemic issue. Convert the failure into a skill and a mechanical gate so it stops repeating.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-07-22", "failure": "The owner had to report the same failure twice; recurring failures were fixed in chat and forgotten instead of converted into a skill plus a mechanical gate." } ], "human": "/skills/shared-failure-to-skill", "json": "/api/skills/shared-failure-to-skill", "skill": "/api/skills/shared-failure-to-skill/skill", "folder_zip": "/api/skills/shared-failure-to-skill/bundle?format=zip" }, { "name": "shared-no-new-problems", "family": "the loop", "description": "Use when the owner asks for a fix or reports a failure. Fix it without asking permission and without creating new problems.", "license": "site", "source": "this build", "prevents": [ { "date": "recurring", "failure": "Fixes that created new failures elsewhere, and fixes that stopped to ask permission the owner had already given." } ], "human": "/skills/shared-no-new-problems", "json": "/api/skills/shared-no-new-problems", "skill": "/api/skills/shared-no-new-problems/skill", "folder_zip": "/api/skills/shared-no-new-problems/bundle?format=zip" }, { "name": "shared-rule-capture", "family": "the loop", "description": "Use when the owner restates a rule, correction, or constraint, or when a governor report shows high owner-restatement counts.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-07", "failure": "The owner restated the same rule across sessions because corrections were acknowledged conversationally and never written into a durable rule." } ], "human": "/skills/shared-rule-capture", "json": "/api/skills/shared-rule-capture", "skill": "/api/skills/shared-rule-capture/skill", "folder_zip": "/api/skills/shared-rule-capture/bundle?format=zip" }, { "name": "shared-say-no", "family": "the loop", "description": "Use ONLY when answering an evaluative question — \"anything to add\", \"any ideas\", \"anything wrong\", \"is this good/A+\", a review, an audit, or a decision about whether something can be deleted. NEVER use it to answer a work instruction. Absorbed into thinking-law (owner order, 2026-08-06) as the restraint family — load thinking-law for the full verdict rules.", "license": "site", "source": "this build", "prevents": [ { "date": "2026-07-23", "failure": "Asked \"any ideas?\", models produced ideas whether or not any were good; asked \"is this A+?\", they appended pattern-matched suggestion tails to passing work. Same day, the first draft of this very rule made a fresh agent suppress a real infinite-loop bug to answer \"Yes.\" — both failure modes are now clauses." } ], "human": "/skills/shared-say-no", "json": "/api/skills/shared-say-no", "skill": "/api/skills/shared-say-no/skill", "folder_zip": "/api/skills/shared-say-no/bundle?format=zip" }, { "name": "skill-creator", "family": "the loop", "description": "Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.", "license": "Apache-2.0", "source": "anthropics/skills", "prevents": [ { "date": "recurring", "failure": "Skill edits judged by rereading instead of behavior — no baseline run, no with-skill run, no evidence the edit taught anything." } ], "human": "/skills/skill-creator", "json": "/api/skills/skill-creator", "skill": "/api/skills/skill-creator/skill", "folder_zip": "/api/skills/skill-creator/bundle?format=zip" }, { "name": "writing-skills", "family": "the loop", "description": "Use when creating new skills, editing existing skills, or verifying skills work before deployment", "license": "MIT", "source": "obra/superpowers", "prevents": [ { "date": "recurring", "failure": "Skills written from imagination — describing what nobody failed at — that no agent could act on under pressure." } ], "human": "/skills/writing-skills", "json": "/api/skills/writing-skills", "skill": "/api/skills/writing-skills/skill", "folder_zip": "/api/skills/writing-skills/bundle?format=zip" } ], "folder_zip": "/api/skills/bundle?format=zip" }