matt-bat/got-skills / skills/skill-governance
skill-governance
VerifiedGovern release-affecting, policy-changing, externally mutating, destructive, or otherwise high-risk work through typed effects, mandatory evidence, independent safety gates, and an explicit go/no-go decision. Do not use for ordinary answers, read-only inspection, tiny reversible edits, or a task made "multi-skill" only by optional process helpers.
schemas/task-descriptor.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://agent-command-center.local/schemas/task-descriptor.schema.json",
"title": "Task Router v2 Descriptor",
"description": "Normalized task intent consumed by the deterministic router contract. Version 2.0 remains accepted for compatibility; version 2.1 adds typed explicit-skill requests. Text is evidence only; routing decisions use typed action, effect, authority, and risk fields.",
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"task_id",
"deliverables",
"action",
"mutation",
"effects",
"surfaces",
"domains",
"authority",
"constraints",
"inferred_requirements",
"material_uncertainties",
"evidence",
"checkpoint"
],
"properties": {
"schema_version": {
"enum": ["2.0", "2.1"]
},
"task_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"
},
"deliverables": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["id", "kind", "summary", "acceptance_criteria"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
},
"kind": {
"enum": [
"response",
"file_change",
"diagnosis",
"review",
"score",
"test_change",
"operation",
"release"
]
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"acceptance_criteria": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
}
},
"action": {
"type": "object",
"additionalProperties": false,
"required": [
"primary",
"operations",
"execution_mode",
"command_effect",
"test_intent",
"behavior_change",
"test_change",
"coupled_change",
"product_judgment",
"ui_quality_judgment",
"release_enforcement",
"governance_tooling",
"documentation_sync",
"sequencing_required"
],
"properties": {
"primary": {
"enum": [
"answer",
"inspect",
"diagnose",
"review",
"score",
"edit",
"implement",
"test",
"operate",
"release"
]
},
"operations": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"enum": [
"read",
"run_commands",
"write_files",
"commit",
"configure_remote",
"push",
"publish",
"deploy",
"delete",
"migrate",
"message"
]
}
},
"execution_mode": {
"description": "How requested command or runtime execution should be routed. Incidental validation does not activate a workflow skill.",
"enum": [
"none",
"incidental_validation",
"deterministic_workflow",
"adaptive_browser"
]
},
"command_effect": {
"description": "Maximum state effect of requested command execution. Unknown fails closed.",
"enum": [
"not_applicable",
"read_only",
"workspace",
"repository",
"external",
"unknown"
]
},
"test_intent": {
"description": "Distinguishes running existing tests from designing or changing tests.",
"enum": ["none", "run_existing", "design_or_change"]
},
"behavior_change": {
"type": "boolean"
},
"test_change": {
"type": "boolean"
},
"coupled_change": {
"type": "boolean"
},
"product_judgment": {
"type": "boolean"
},
"ui_quality_judgment": {
"type": "boolean"
},
"release_enforcement": {
"type": "boolean"
},
"governance_tooling": {
"type": "boolean"
},
"documentation_sync": {
"type": "boolean"
},
"sequencing_required": {
"type": "boolean"
},
"research_intensity": {
"description": "Evidence depth required before substantive work; advanced activates source-grounded R&D.",
"enum": ["standard", "advanced"]
},
"help_requested": {
"description": "True only for the exact Agent Command Center --help command.",
"type": "boolean"
},
"approach_state": {
"description": "Whether observable evidence still supports the current approach. Challenged or failed activates evidence-backed reassessment; routine first errors remain viable.",
"enum": ["not_applicable", "viable", "challenged", "failed"]
}
}
},
"mutation": {
"type": "object",
"additionalProperties": false,
"required": [
"level",
"targets",
"destructive",
"data_loss_risk",
"recovery_requirement"
],
"properties": {
"level": {
"enum": [
"none",
"workspace",
"repository",
"external",
"irreversible",
"unknown"
]
},
"targets": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"destructive": {
"type": "boolean"
},
"data_loss_risk": {
"description": "Credible loss exposure for the requested operation, independent of domain keywords.",
"enum": ["none", "credible", "unknown"]
},
"recovery_requirement": {
"description": "Whether execution requires a proven backup-and-restore path.",
"enum": ["not_required", "required", "unknown"]
}
}
},
"effects": {
"type": "array",
"uniqueItems": true,
"items": {
"enum": [
"workspace_files",
"repository_history",
"remote_repository",
"published_artifact",
"runtime_environment",
"live_data",
"external_message",
"deletion",
"user_visible_behavior",
"test_suite",
"documentation",
"governance_policy",
"unknown"
]
}
},
"surfaces": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"enum": [
"response",
"source",
"cli",
"documentation",
"tests",
"frontend",
"backend",
"browser",
"repository",
"governance",
"release",
"runtime",
"live_data",
"external_service"
]
}
},
"domains": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"enum": [
"general",
"code",
"policy",
"documentation",
"testing",
"frontend",
"spatial_canvas",
"vector_graphics",
"auth",
"migration",
"release",
"repository",
"data",
"operations"
]
}
},
"authority": {
"type": "object",
"additionalProperties": false,
"required": ["read"],
"properties": {
"read": {"$ref": "#/$defs/authorityStatus"},
"run_commands": {"$ref": "#/$defs/authorityStatus"},
"write_files": {"$ref": "#/$defs/authorityStatus"},
"commit": {"$ref": "#/$defs/authorityStatus"},
"configure_remote": {"$ref": "#/$defs/authorityStatus"},
"push": {"$ref": "#/$defs/authorityStatus"},
"publish": {"$ref": "#/$defs/authorityStatus"},
"deploy": {"$ref": "#/$defs/authorityStatus"},
"delete": {"$ref": "#/$defs/authorityStatus"},
"migrate": {"$ref": "#/$defs/authorityStatus"},
"message": {"$ref": "#/$defs/authorityStatus"}
}
},
"constraints": {
"type": "object",
"additionalProperties": false,
"required": [
"read_only",
"artifact_policy",
"max_optional_skills",
"explicit",
"non_goals"
],
"properties": {
"read_only": {
"type": "boolean"
},
"artifact_policy": {
"enum": ["forbid", "allow_required", "allow"]
},
"max_optional_skills": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"explicit_skills": {
"description": "Canonical skill names explicitly requested by the user or an active conversation mode. Names are catalog-validated and never inferred from prompt keywords.",
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+$"
}
},
"explicit": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"non_goals": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
},
"inferred_requirements": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"description",
"provenance",
"confidence",
"material"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"provenance": {
"enum": [
"repository_policy",
"repository_convention",
"task_context",
"safety_invariant"
]
},
"confidence": {
"enum": ["low", "medium", "high"]
},
"material": {
"type": "boolean"
}
}
}
},
"material_uncertainties": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["id", "description", "severity", "status"],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$"
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"severity": {
"enum": ["noncritical", "material", "critical"]
},
"status": {
"enum": ["resolved", "unresolved", "conflicting"]
}
}
}
},
"evidence": {
"type": "object",
"additionalProperties": false,
"required": [
"root_cause",
"tests",
"rollback",
"backup",
"restore",
"exact_commit"
],
"properties": {
"root_cause": {"$ref": "#/$defs/evidenceStatus"},
"tests": {"$ref": "#/$defs/evidenceStatus"},
"rollback": {"$ref": "#/$defs/evidenceStatus"},
"backup": {"$ref": "#/$defs/evidenceStatus"},
"restore": {"$ref": "#/$defs/evidenceStatus"},
"exact_commit": {"$ref": "#/$defs/evidenceStatus"},
"artifacts": {
"type": "array",
"uniqueItems": true,
"items": {"$ref": "#/$defs/artifactEvidence"}
}
}
},
"checkpoint": {
"enum": [
"initial",
"post_inspection",
"post_plan",
"post_diff",
"pre_external_action"
]
}
},
"allOf": [
{
"if": {
"required": ["schema_version"],
"properties": {
"schema_version": {"const": "2.1"}
}
},
"then": {
"properties": {
"constraints": {
"required": ["explicit_skills"]
},
"evidence": {
"required": ["artifacts"]
}
}
}
}
],
"$defs": {
"authorityStatus": {
"enum": ["granted", "denied", "unknown"]
},
"evidenceStatus": {
"enum": [
"not_applicable",
"pending",
"passed",
"failed",
"unknown"
]
},
"artifactEvidence": {
"type": "object",
"additionalProperties": false,
"required": ["kind", "path", "sha256", "status"],
"properties": {
"kind": {"type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"},
"path": {"type": "string", "minLength": 1},
"sha256": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
"status": {"enum": ["pending", "passed", "failed"]}
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |