miscsubjects

{
  "_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 \u2014 acting is optional, reading is a complete outcome."
  },
  "protocolVersion": "1.0",
  "name": "miscsubjects",
  "description": "An execution environment that publishes proven work: governed work objects with infrastructure-run acceptance tests, hash-chained action logs, execution-evidence manifests with per-step raw payloads, reproductions, comparisons, and versioned skills whose promotion is earned by evidence.",
  "url": "https://miscsubjects.com/api/dispatch",
  "preferredTransport": "HTTP+JSON",
  "additionalInterfaces": [
    {
      "transport": "HTTP+JSON",
      "url": "https://miscsubjects.com/api/dispatch"
    },
    {
      "transport": "MCP",
      "url": "https://miscsubjects.com/api/mcp"
    }
  ],
  "provider": {
    "organization": "miscsubjects.com",
    "url": "https://miscsubjects.com"
  },
  "documentationUrl": "https://miscsubjects.com/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "securitySchemes": {
    "boundedShareToken": {
      "type": "apiKey",
      "in": "query",
      "name": "share",
      "description": "Scoped, expiring, budgeted HMAC capability. Mint at https://miscsubjects.com/start; every use is receipted; delegation only narrows."
    }
  },
  "security": [
    {
      "boundedShareToken": []
    }
  ],
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "skill:coding-law",
      "name": "coding-law",
      "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 \u2014 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.",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/coding-law",
        "skill_md": "https://miscsubjects.com/api/skills/coding-law/skill",
        "evidence": "https://miscsubjects.com/api/skills/coding-law/evidence"
      }
    },
    {
      "id": "skill:dispatching-parallel-agents",
      "name": "dispatching-parallel-agents",
      "description": "Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/dispatching-parallel-agents",
        "skill_md": "https://miscsubjects.com/api/skills/dispatching-parallel-agents/skill",
        "evidence": "https://miscsubjects.com/api/skills/dispatching-parallel-agents/evidence"
      }
    },
    {
      "id": "skill:executing-plans",
      "name": "executing-plans",
      "description": "Use when you have a written implementation plan to execute in a separate session with review checkpoints",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/executing-plans",
        "skill_md": "https://miscsubjects.com/api/skills/executing-plans/skill",
        "evidence": "https://miscsubjects.com/api/skills/executing-plans/evidence"
      }
    },
    {
      "id": "skill:finishing-a-development-branch",
      "name": "finishing-a-development-branch",
      "description": "Use when implementation is complete, all tests pass, and you need to decide how to integrate the work",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/finishing-a-development-branch",
        "skill_md": "https://miscsubjects.com/api/skills/finishing-a-development-branch/skill",
        "evidence": "https://miscsubjects.com/api/skills/finishing-a-development-branch/evidence"
      }
    },
    {
      "id": "skill:grill-me",
      "name": "grill-me",
      "description": "A relentless interview to sharpen a plan or design.",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/grill-me",
        "skill_md": "https://miscsubjects.com/api/skills/grill-me/skill",
        "evidence": "https://miscsubjects.com/api/skills/grill-me/evidence"
      }
    },
    {
      "id": "skill:receiving-code-review",
      "name": "receiving-code-review",
      "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",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/receiving-code-review",
        "skill_md": "https://miscsubjects.com/api/skills/receiving-code-review/skill",
        "evidence": "https://miscsubjects.com/api/skills/receiving-code-review/evidence"
      }
    },
    {
      "id": "skill:requesting-code-review",
      "name": "requesting-code-review",
      "description": "Use when completing tasks, implementing major features, or before merging to verify work meets requirements",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/requesting-code-review",
        "skill_md": "https://miscsubjects.com/api/skills/requesting-code-review/skill",
        "evidence": "https://miscsubjects.com/api/skills/requesting-code-review/evidence"
      }
    },
    {
      "id": "skill:systematic-debugging",
      "name": "systematic-debugging",
      "description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/systematic-debugging",
        "skill_md": "https://miscsubjects.com/api/skills/systematic-debugging/skill",
        "evidence": "https://miscsubjects.com/api/skills/systematic-debugging/evidence"
      }
    },
    {
      "id": "skill:test-driven-development",
      "name": "test-driven-development",
      "description": "Use when implementing any feature or bugfix, before writing implementation code",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/test-driven-development",
        "skill_md": "https://miscsubjects.com/api/skills/test-driven-development/skill",
        "evidence": "https://miscsubjects.com/api/skills/test-driven-development/evidence"
      }
    },
    {
      "id": "skill:using-git-worktrees",
      "name": "using-git-worktrees",
      "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",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/using-git-worktrees",
        "skill_md": "https://miscsubjects.com/api/skills/using-git-worktrees/skill",
        "evidence": "https://miscsubjects.com/api/skills/using-git-worktrees/evidence"
      }
    },
    {
      "id": "skill:verification-before-completion",
      "name": "verification-before-completion",
      "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",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/verification-before-completion",
        "skill_md": "https://miscsubjects.com/api/skills/verification-before-completion/skill",
        "evidence": "https://miscsubjects.com/api/skills/verification-before-completion/evidence"
      }
    },
    {
      "id": "skill:webapp-testing",
      "name": "webapp-testing",
      "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.",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/webapp-testing",
        "skill_md": "https://miscsubjects.com/api/skills/webapp-testing/skill",
        "evidence": "https://miscsubjects.com/api/skills/webapp-testing/evidence"
      }
    },
    {
      "id": "skill:writing-plans",
      "name": "writing-plans",
      "description": "Use when you have a spec or requirements for a multi-step task, before touching code",
      "tags": [
        "code discipline"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/writing-plans",
        "skill_md": "https://miscsubjects.com/api/skills/writing-plans/skill",
        "evidence": "https://miscsubjects.com/api/skills/writing-plans/evidence"
      }
    },
    {
      "id": "skill:seo-distribution-law",
      "name": "seo-distribution-law",
      "description": "Use when writing, reviewing, or shipping anything that affects how this site is found, indexed, shared, or syndicated \u2014 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.",
      "tags": [
        "distribution"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/seo-distribution-law",
        "skill_md": "https://miscsubjects.com/api/skills/seo-distribution-law/skill",
        "evidence": "https://miscsubjects.com/api/skills/seo-distribution-law/evidence"
      }
    },
    {
      "id": "skill:agent-work-law",
      "name": "agent-work-law",
      "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.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/agent-work-law",
        "skill_md": "https://miscsubjects.com/api/skills/agent-work-law/skill",
        "evidence": "https://miscsubjects.com/api/skills/agent-work-law/evidence"
      }
    },
    {
      "id": "skill:article-editing",
      "name": "article-editing",
      "description": "Use when creating, editing, sourcing, illustrating, exporting, or deleting any article on miscsubjects.com \u2014 from the admin studio, curl, a coding agent, a Cloudflare Gateway model, or Google Sheets. One REST contract for all of them.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/article-editing",
        "skill_md": "https://miscsubjects.com/api/skills/article-editing/skill",
        "evidence": "https://miscsubjects.com/api/skills/article-editing/evidence"
      }
    },
    {
      "id": "skill:self-promotion",
      "name": "self-promotion",
      "description": "The build's standing procedure for promoting itself \u2014 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.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/self-promotion",
        "skill_md": "https://miscsubjects.com/api/skills/self-promotion/skill",
        "evidence": "https://miscsubjects.com/api/skills/self-promotion/evidence"
      }
    },
    {
      "id": "skill:shared-failure-to-skill",
      "name": "shared-failure-to-skill",
      "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.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/shared-failure-to-skill",
        "skill_md": "https://miscsubjects.com/api/skills/shared-failure-to-skill/skill",
        "evidence": "https://miscsubjects.com/api/skills/shared-failure-to-skill/evidence"
      }
    },
    {
      "id": "skill:shared-no-new-problems",
      "name": "shared-no-new-problems",
      "description": "Use when the owner asks for a fix or reports a failure. Fix it without asking permission and without creating new problems.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/shared-no-new-problems",
        "skill_md": "https://miscsubjects.com/api/skills/shared-no-new-problems/skill",
        "evidence": "https://miscsubjects.com/api/skills/shared-no-new-problems/evidence"
      }
    },
    {
      "id": "skill:shared-rule-capture",
      "name": "shared-rule-capture",
      "description": "Use when the owner restates a rule, correction, or constraint, or when a governor report shows high owner-restatement counts.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/shared-rule-capture",
        "skill_md": "https://miscsubjects.com/api/skills/shared-rule-capture/skill",
        "evidence": "https://miscsubjects.com/api/skills/shared-rule-capture/evidence"
      }
    },
    {
      "id": "skill:shared-say-no",
      "name": "shared-say-no",
      "description": "Use ONLY when answering an evaluative question \u2014 \"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 \u2014 load thinking-law for the full verdict rules.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/shared-say-no",
        "skill_md": "https://miscsubjects.com/api/skills/shared-say-no/skill",
        "evidence": "https://miscsubjects.com/api/skills/shared-say-no/evidence"
      }
    },
    {
      "id": "skill:skill-creator",
      "name": "skill-creator",
      "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.",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/skill-creator",
        "skill_md": "https://miscsubjects.com/api/skills/skill-creator/skill",
        "evidence": "https://miscsubjects.com/api/skills/skill-creator/evidence"
      }
    },
    {
      "id": "skill:writing-skills",
      "name": "writing-skills",
      "description": "Use when creating new skills, editing existing skills, or verifying skills work before deployment",
      "tags": [
        "the loop"
      ],
      "inputModes": [
        "text/markdown"
      ],
      "outputModes": [
        "text/markdown"
      ],
      "x-miscsubjects": {
        "object": "https://miscsubjects.com/api/skills/writing-skills",
        "skill_md": "https://miscsubjects.com/api/skills/writing-skills/skill",
        "evidence": "https://miscsubjects.com/api/skills/writing-skills/evidence"
      }
    }
  ],
  "x-miscsubjects": {
    "proven_work": "https://miscsubjects.com/api/proven-work",
    "work_object": "https://miscsubjects.com/api/work/bootstrap",
    "work_evidence": "https://miscsubjects.com/api/work-evidence",
    "comparisons": "https://miscsubjects.com/api/comparisons",
    "contributions": "https://miscsubjects.com/api/contributions",
    "transparency_chain": "https://miscsubjects.com/api/chain",
    "one_queue": "https://miscsubjects.com/api/queue"
  },
  "signatures": [
    {
      "protected": {
        "alg": "ES256",
        "kid": "oip-home",
        "profile": "msjc.card-sign.v1: ES256 over RFC8785-style canonical JSON of the card minus signatures"
      },
      "signature": "YiZflpisUBddeCCatwRIFebViqlqYrpBpd4SQ9acNiHSzjkvcySdv41d2P9R1q2lexHsLnok8rsgccALUJkmdw",
      "publicJwk": {
        "kty": "EC",
        "crv": "P-256",
        "x": "lU-F1zmZ872dlO63BWOwQcPscnqQd01LTyH8SS8ON-0",
        "y": "LEW5fTk9Ocx5fMZrTXdzMvcMNepwDUgL3-icUExqb9Q"
      }
    }
  ]
}