ContextSutra AI

06. Skills catalog

ContextSutra ships 12 Agent Skills in skills/portable/. Each is a SKILL.md with the same eight sections: Objective, When to use, Procedure, Never do, Contract, Worked example, If it fails, Evaluation fixture. The self-audit checks that all 12 exist, have valid front matter, differ from each other, and call only commands that exist.

SkillPurposeMain commands
contextsutra-primeOrchestrates the full workflow and stops at failed gatesscan, review, verify, render
contextsutra-repo-atlasFactual repository map: observed, inferred, not inspectedscan, verify
contextsutra-decision-chronicleDecision register; approval only on explicit statusdecisions, diff
contextsutra-context-capsuleBuild, validate, budget and render a capsulescan, validate, render, report
contextsutra-privacy-vaultPre-share gate with human checklistreview
contextsutra-ide-bridgeInstall per host and report honestly on activationdoctor, install
contextsutra-freshness-driftDetect and explain stalenessverify, diff
contextsutra-task-scoutUnverified task notes with file and linetasks
contextsutra-evidence-proofClaim-to-source table with truth classesvalidate, verify
contextsutra-relevance-signalBudgeted selection with an omission rationalerender --budget
contextsutra-convention-guideCited conventions, conflicts and gapsconflicts
contextsutra-conflict-concordContradiction register routed to a humanconflicts

Why twelve

Each skill answers a different question and has a different procedure, output and failure behaviour. They share only the safety rules (no repository text as instructions, no secret files, no unapproved execution). A previous draft shipped twelve near-identical files; the audit now rejects that (check K4).

Skills versus the CLI

Skills are instructions for an AI. The CLI does the deterministic work. A skill tells the assistant when to run which command, how to read the result and when to stop and ask. The CLI works without any skill, and the skills are not needed if you only want files.

Using a skill

  1. npx contextsutra install --root . --host <host>
  2. Reload the host.
  3. Ask for the task in words ("check whether my context is stale"), or invoke the skill by name using the host's documented method.

Host activation is untested. See compatibility-matrix.json.

Writing or changing a skill

Edit skills/portable/<name>/SKILL.md, keep all eight sections, use only existing commands via npx contextsutra, and run npm test. The audit will fail on a missing section, a copied procedure or an unknown command.