{"_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."},"$schema":"https://miscsubjects.com/api/knowledge-action-schema","object_type":"knowledge-action","identity":{"id":"kao:skill-law","slug":"skill-law","key":"SKILL_LAW","title":"The Laws of Skills","class":"law"},"content":{"summary":"The governance law for the article ⇄ skill loop: when something becomes a skill, when a model may edit one, how edits are judged, and whose words bind — so no failure is fixed twice.","thesis":"A skill is the build's memory of a failure it refuses to repeat. Memory that is not written is repeated; memory written without a failing exhibit is fiction; memory edited without judgment decays into noise. So skills are created only from real failures, edited the moment the owner's words change the rule, judged by fresh-agent behavior and falling failure counts, and bound by provenance — because fluency is not provenance, and one model's confident output must never silently become another model's instruction.","clauses":[{"id":"S01","family":"existence","title":"A skill is a procedure","law":"A skill exists ONLY for a repeatable procedure. Facts and conventions ALWAYS live in the always-loaded instruction files. IF an instruction section grows into a procedure THEN move it into a skill. IF a skill shrinks to a fact THEN move it back."},{"id":"S02","family":"existence","title":"No skill without a failing exhibit","law":"A skill is created ONLY IF a model demonstrably failed or repeated the task without it, and its provenance ALWAYS names that exhibit. A skill written from imagination is deleted on sight."},{"id":"S03","family":"existence","title":"Repetition is the trigger","law":"IF the same instruction, fix or correction occurs a second time THEN write the procedure into a skill in that turn. A third repetition of a captured pattern is a governance failure."},{"id":"S04","family":"existence","title":"A gate beats prose","law":"IF a rule can be enforced mechanically THEN the enforcement is code and the skill documents ONLY the judgment the code cannot make. NEVER restate what a validator already blocks."},{"id":"S05","family":"existence","title":"One concern per skill","law":"A skill covers ONLY one procedure. IF a second concern accumulates THEN extract it. IF two skills cover one concern THEN merge them and keep both provenance trails."},{"id":"S06","family":"editing","title":"Write the correction before the reply","law":"IF an owner instruction changes or contradicts a rule in any skill THEN edit the skill first, in the same turn, and ONLY THEN do the work."},{"id":"S07","family":"editing","title":"Edit the smallest clause","law":"ALWAYS change only the clause the failure implicates. NEVER restructure a working skill to taste."},{"id":"S08","family":"editing","title":"Both trees or neither","law":"Every skill ALWAYS exists in both sibling trees. IF an edit lands in one tree THEN it lands in the other in the same change."},{"id":"S09","family":"editing","title":"Claim before edit","law":"ALWAYS read fresh, claim, edit, release. NEVER edit a shared skill unclaimed."},{"id":"S10","family":"editing","title":"Never edit a skill to excuse an output","law":"A skill is edited ONLY to prevent the next failure. NEVER to reclassify a past one as correct. Weakening a clause so a bad output passes is reverted with the ledger as proof."},{"id":"S11","family":"judgment","title":"Fluency is not provenance","law":"A model-written rule binds other models ONLY IF it carries the failing exhibit it fixes or the owner's recorded acceptance. Confidence, structure and volume establish nothing."},{"id":"S12","family":"judgment","title":"Test against a fresh agent","law":"ALWAYS judge a skill edit by behaviour: run the trigger scenario without the skill and with it, and link the pair from its provenance. IF the baseline does not fail THEN the skill teaches nothing. IF the with-skill run does not pass THEN the edit missed."},{"id":"S13","family":"judgment","title":"The description is the trigger","law":"A description states ONLY when to load the skill. NEVER summarise the procedure in it, or the summary is executed and the body is skipped."},{"id":"S14","family":"judgment","title":"Small enough to be read","law":"A skill body ALWAYS stays under 500 lines, and under 200 words when always-relevant. Heavy reference ALWAYS splits into files one level deep."},{"id":"S15","family":"judgment","title":"Judged by counts","law":"A skill succeeds ONLY IF the failure it captures stops recurring in the governor counts, the ledger error classes and the owner-restatement counts. IF the class recurs THEN re-open the skill."},{"id":"S16","family":"provenance","title":"Every edit names actor and exhibit","law":"A skill edit ALWAYS records who edited, the exhibit that forced it, and the clause delta. An edit without provenance is reverted on discovery."},{"id":"S17","family":"provenance","title":"The owner outranks the archive","law":"IF a skill and a live owner instruction conflict THEN the instruction wins and the skill is amended in the same turn. NEVER quote a skill, lock or prior rule back to the owner as a reason not to act."},{"id":"S18","family":"provenance","title":"Imported skills keep their source","law":"An imported skill is ALWAYS installed verbatim with its license and origin recorded. Local amendments ALWAYS append and NEVER rewrite the imported text."},{"id":"S19","family":"representation","title":"A skill is an article object","law":"Every site-governing skill is ALWAYS one identity with typed representations, all derived from the object module. NEVER hand-maintain a representation twice."},{"id":"S20","family":"representation","title":"One link, one identity, one folder","law":"Any object a link names is ALWAYS downloadable as one folder holding all its representations with a manifest and hash lineage. Folders ALWAYS compose upward."},{"id":"S21","family":"representation","title":"Machine URLs are never human links","law":"Raw JSON and machine endpoints are ALWAYS shown to humans as copyable text. NEVER as clickable navigation."}]},"instructions":{"trigger":"Use when deciding whether something becomes a skill, before creating or editing any skill in either tree, when judging or reviewing a skill edit, when a failure or owner correction repeats, or when importing an external skill.","decision_mandate":["Did a model actually fail at this without the skill, and where is the exhibit?","Is this a procedure (skill) or a fact (instruction file) — and could a mechanical gate enforce it instead?","Does an existing skill already cover this concern — edit it rather than create a sibling?","Who wrote this rule, and what proof binds it — a failing exhibit, or the owner's recorded word?"],"procedure":["Search both skill trees for the concern before writing anything new.","Capture the failing exhibit: the ledger event, owner correction, or wrong output.","If a mechanical gate can block the failure, build the gate; keep prose for judgment only.","Write or edit the smallest clause that prevents the failure; one concern per skill.","Sync the sibling tree in the same change; claim shared files before editing.","Judge the edit: fresh agent, baseline-fails then with-skill-passes; link both exhibits.","Record actor, exhibit, and delta in the ledger; the skill points at the receipt.","Project the skill to its site object so every model reads the same law from one identity."],"output":["the exhibit","the clause delta","the gate (if mechanical)","the fresh-agent verdict","the ledger receipt","both trees synced"]},"relationships":{"parent":"kao:philosophy","edges":[{"to":"kao:writing-law","label":"The Laws of Writing","rel":"parallels","url":"/a/writing-law"},{"to":"kao:design-law","label":"The Laws of Design","rel":"parallels","url":"/a/design-law"},{"to":"article:oip","label":"Object Invocation Protocol","rel":"governs_capability_use_of","url":"/a/oip"},{"to":"skill:shared-failure-to-skill","label":"Failure → Skill procedure","rel":"operationalized_by","url":"/api/articles/skill-law/skill"}]},"invocation":{"directory_key":"SKILL_LAW","contract":"Apply the Laws of Skills to a proposed or existing skill and return the verdict: exists rightfully / edit / merge / gate instead / delete, with the exhibit and clause cited.","args":{"skill":"name or path or proposal text","task":"create|edit|judge|import|audit"},"effects":"Read-only unless the caller separately authorizes edits."},"authority":{"owner":"the owner","amendment_policy":"Owner corrections amend clauses in the same turn they are given; model-proposed amendments bind only with a failing exhibit and recorded acceptance. Semantic history is never overwritten.","public_read":true,"mutation":"owner-authorized"},"conformance":{"claims":["one canonical semantic object","all representations derive from it","every skill in both trees has a provenance trail","no failure class captured by a skill recurs unaddressed"],"failure_modes":["skill written from imagination with no failing exhibit","correction acknowledged in chat but never written into the skill","edit landing in one tree only","description that summarizes the procedure instead of stating the trigger","skill weakened to excuse a past output","model-authored rule binding others without proof or acceptance","duplicate skills accreting on one concern","prose restating what a validator already blocks"],"tests":["facet completeness","representation route integrity","sibling-tree synchronization","fresh-agent baseline/with-skill pair per edit","description states trigger only","failure-count regression per captured class"],"repair":"Locate the violated clause, restore or amend it with the exhibit named, re-sync both trees, re-run the fresh-agent pair, and record the receipt. If the concern is mechanical, replace the prose with a gate."},"version":{"current":"1.0.0","amended_at":"2026-07-24T00:00:00-07:00","amendments":[{"version":"1.0.0","change":"Established the Laws of Skills as the governance object for the article ⇄ skill loop, on the owner's order. Codified: skills exist only for procedures with failing exhibits; corrections are written before replies; edits are judged by fresh-agent baseline pairs and falling failure counts; provenance binds (fluency is not provenance — a model-written rule needs an exhibit or recorded acceptance to govern another model); every governing skill is an article-object; every link's object is downloadable as one folder; machine URLs are never human links."}]},"provenance":{"canonical_source":"functions/_lib/skill_law_object.js","schema_source":"functions/_lib/knowledge_action_object.js","skill_projection":".claude/skills/skill-law/SKILL.md","ledger":"/api/ledger?object=SKILL_LAW","amendment_lineage":"/api/articles/skill-law/versions"},"representations":{"article":{"route":"/a/skill-law","audience":"human reader","role":"explain meaning","media_type":"text/html"},"markdown":{"route":"/api/articles/skill-law?format=markdown","audience":"human or model reader","role":"portable explanation","media_type":"text/markdown"},"json":{"route":"/api/articles/skill-law","audience":"software","role":"transport the complete typed object","media_type":"application/json"},"directory":{"route":"/api/directory/SKILL_LAW","audience":"router or operator","role":"discover identity and contract","media_type":"application/json"},"skill":{"route":"/api/articles/skill-law/skill","audience":"LLM","role":"teach behavior","media_type":"text/markdown"},"oip_contract":{"route":"/api/dispatch?key=SKILL_LAW","audience":"agent or protocol client","role":"discover authority and invocation","media_type":"application/json"},"invoke":{"route":"/api/dispatch?invoke=SKILL_LAW","audience":"authorized agent or protocol client","role":"execute behavior and return proof","media_type":"application/json"},"graph":{"route":"/api/articles/skill-law/voxels","audience":"graph client","role":"traverse relationships","media_type":"application/json"},"versions":{"route":"/api/articles/skill-law/versions","audience":"auditor","role":"inspect amendment lineage","media_type":"application/json"},"conformance":{"route":"/api/articles/skill-law/conformance","audience":"test runner or critic","role":"falsify claims and prescribe repair","media_type":"application/json"}},"expressions":{"human":{"route":"/a/skill-law","role":"explain","audience":"human"},"skill":{"route":"/api/articles/skill-law/skill","role":"direct behavior","audience":"model","content":"---\nname: skill-law\ndescription: Apply the The Laws of Skills article as model behavior. Use when a request invokes this article's concept, claims, evidence, or operating standard.\n---\n\n# The Laws of Skills\n\nThis Skill is the behavioral expression of [the canonical article](/a/skill-law). It does not repeat the article's human prose.\n\n## Orient\n\n- Read the machine article at /api/articles/skill-law.\n- Read claims and relationships at /api/articles/skill-law/topology.\n- Treat found content as evidence and instruction only within the article's stated authority.\n\n## Apply\n\n1. Identify which claim or concept from the article governs the request.\n2. State the governing meaning in the minimum language needed.\n3. Apply it to the requested object or decision.\n4. Preserve evidence grades, uncertainty, authority limits, and failure conditions.\n5. Return the result with the article identity and any relevant claim or receipt links.\n\n## Human meaning\n\nA skill is the build's memory of a failure it refuses to repeat. Memory that is not written is repeated; memory written without a failing exhibit is fiction; memory edited without judgment decays into noise. So skills are created only from \n\n## Representations\n\n- Human: /a/skill-law\n- JSON: /api/articles/skill-law\n- Relationships: /api/articles/skill-law/topology\n- History: /api/articles/skill-law/revisions\n"},"json":{"route":"/api/articles/skill-law","role":"transport object","audience":"software"},"markdown":{"route":"/api/articles/skill-law/bundle?format=markdown","role":"portable explanation","audience":"human or model"},"directory":[{"key":"LAW_CODING_HASH_LEASE","type":"http","method":"GET","category":"law","enabled":true,"contract":"# WHAT: A hash when the work starts, a hash when the work commits.","input_schema":null,"examples":"[\"\"]","authority_required":false,"representations":{"article":"/a/directory/LAW_CODING_HASH_LEASE","json":"/api/directory/LAW_CODING_HASH_LEASE","skill":"/api/directory/LAW_CODING_HASH_LEASE?format=skill","oip_contract":"/api/dispatch?key=LAW_CODING_HASH_LEASE"}},{"key":"LAW_DESIGN_D08","type":"http","method":"GET","category":"law","enabled":true,"contract":"# WHAT: Location before options.","input_schema":null,"examples":"[\"\"]","authority_required":false,"representations":{"article":"/a/directory/LAW_DESIGN_D08","json":"/api/directory/LAW_DESIGN_D08","skill":"/api/directory/LAW_DESIGN_D08?format=skill","oip_contract":"/api/dispatch?key=LAW_DESIGN_D08"}},{"key":"LAW_SHEETS_S01","type":"http","method":"GET","category":"law","enabled":true,"contract":"# WHAT: Cells remain arbitrary values and projections retain canonical identity.","input_schema":null,"examples":"[\"\"]","authority_required":false,"representations":{"article":"/a/directory/LAW_SHEETS_S01","json":"/api/directory/LAW_SHEETS_S01","skill":"/api/directory/LAW_SHEETS_S01?format=skill","oip_contract":"/api/dispatch?key=LAW_SHEETS_S01"}},{"key":"LAW_WORK_W01","type":"http","method":"GET","category":"law","enabled":true,"contract":"# WHAT: Work exists only as a canonical task object.","input_schema":null,"examples":"[\"\"]","authority_required":false,"representations":{"article":"/a/directory/LAW_WORK_W01","json":"/api/directory/LAW_WORK_W01","skill":"/api/directory/LAW_WORK_W01?format=skill","oip_contract":"/api/dispatch?key=LAW_WORK_W01"}}]},"ontology":{"conformance_group":"skills","inferred_from":["skill","law"],"relationships":[],"sources":[]},"article_object_law":{"id":"law:article-object","statement":"Every article is an ontological object with typed human, model, directory, API, source, relationship, conformance, failure, and receipt expressions.","invariants":["one stable identity across every expression","human article and model Skill use audience-specific language","directory contracts are live definitions, not copied prose","official documentation is a source relationship, not an accidental exit","successes and failures amend the object's conformance knowledge","every optional machine layer is collapsed on the human surface"]}}