Skip to content

matt-bat/got-skills / skills/skill-governance

skill-governance

Verified

Govern 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.

FileKindSize
SKILL.mdskill md9.7 KB
fixtures/passed-artifact-evidence.jsonconfig104 B
fixtures/routing-scenarios.jsonconfig44.2 KB
references/governance-artifacts.mdmarkdown5.1 KB
references/risk-and-gates.mdmarkdown4.6 KB
requirements.txtmanifest89 B
schemas/governance-artifact.schema.jsonconfig13.6 KB
schemas/remote-configuration-policy.schema.jsonconfig4.3 KB
schemas/routing-result.schema.jsonconfig7.7 KB
schemas/task-descriptor.schema.jsonconfig13.3 KB
scripts/enforce_governance_ci.pyscript24.4 KB
scripts/generate_governance_artifact.pyscript43.4 KB
scripts/generate_routing_views.pyscript27.6 KB
scripts/governance_common.pyscript14.5 KB
scripts/record_routing_observation.pyscript9.3 KB
scripts/resolve_task_route.pyscript69.4 KB
scripts/validate_governance_artifact.pyscript39.9 KB
scripts/validate_skill_order_sync.pyscript4.0 KB
scripts/validate_skill_policy.pyscript32.3 KB
scripts/verify_remote_configuration.pyscript12.3 KB
tests/test_advanced_svg_render.pyscript5.1 KB
tests/test_conflict_matrix_integrity.pyscript2.1 KB
tests/test_default_skill_quality_gates.pyscript2.9 KB
tests/test_docs_website_navigation.pyscript2.7 KB
tests/test_enforce_governance_scope.pyscript1.7 KB
tests/test_generate_governance_startup.pyscript9.0 KB
tests/test_generate_routing_views.pyscript12.8 KB
tests/test_governance_history_and_pair_integrity.pyscript10.6 KB
tests/test_governance_integrity.pyscript55.7 KB
tests/test_new_skill_integration.pyscript8.3 KB
tests/test_project_index_integrity.pyscript6.4 KB
tests/test_remote_configuration.pyscript5.6 KB
tests/test_routing_observation.pyscript4.3 KB
tests/test_runtime_adapter.pyscript9.2 KB
tests/test_task_routing.pyscript47.5 KB
tests/test_validate_skill_order_sync.pyscript2.4 KB
tests/test_validate_skill_policy_smoke.pyscript869 B

tests/test_docs_website_navigation.py

View on GitHub
from pathlib import Path
import re
import unittest
from urllib.parse import unquote


REPO_ROOT = Path(__file__).resolve().parents[3]
DOCS_ROOT = REPO_ROOT / "skills" / "docs"
DOCS_HOME = DOCS_ROOT / "README.md"
LINK_PATTERN = re.compile(r"(?<!!)\[[^\]]+\]\(([^)]+)\)")
GENERATED_OR_EVIDENCE_PAGES = {
    DOCS_ROOT / "chat-history-index.md",
    DOCS_ROOT / "chat-history-summary.md",
    DOCS_ROOT / "skill-decision-tree.md",
    DOCS_ROOT / "skill-index.md",
}


def local_targets(page: Path):
    for match in LINK_PATTERN.finditer(page.read_text(encoding="utf-8")):
        raw = match.group(1).strip()
        if raw.startswith("<") and raw.endswith(">"):
            raw = raw[1:-1]
        target_text = raw.split(maxsplit=1)[0]
        if target_text.startswith(("#", "http://", "https://", "mailto:")):
            continue
        path_text = unquote(target_text.split("#", 1)[0].split("?", 1)[0])
        if not path_text:
            continue
        target = (REPO_ROOT / path_text.lstrip("/")) if path_text.startswith("/") else (page.parent / path_text)
        yield target.resolve()


class TestDocsWebsiteNavigation(unittest.TestCase):
    def test_documentation_home_indexes_every_docs_page(self):
        home = DOCS_HOME.read_text(encoding="utf-8")
        for page in sorted(DOCS_ROOT.rglob("*.md")):
            if page == DOCS_HOME:
                continue
            relative = page.relative_to(DOCS_ROOT).as_posix()
            with self.subTest(page=relative):
                self.assertIn(f"(./{relative})", home)

    def test_maintained_guide_pages_link_back_to_documentation_home(self):
        for page in sorted(DOCS_ROOT.rglob("*.md")):
            if page == DOCS_HOME or page in GENERATED_OR_EVIDENCE_PAGES:
                continue
            with self.subTest(page=page.relative_to(DOCS_ROOT).as_posix()):
                self.assertIn("[Documentation home]", page.read_text(encoding="utf-8"))

    def test_every_local_docs_link_resolves(self):
        for page in sorted(DOCS_ROOT.rglob("*.md")):
            for target in local_targets(page):
                with self.subTest(
                    page=page.relative_to(REPO_ROOT).as_posix(),
                    target=str(target),
                ):
                    self.assertTrue(target.exists(), f"broken local link from {page}: {target}")

    def test_primary_entry_pages_link_to_documentation_home(self):
        for relative in ("README.md", "START_HERE.md", "skills/README.md", "skills/USAGE.md"):
            page = REPO_ROOT / relative
            with self.subTest(page=relative):
                self.assertIn("docs/README.md", page.read_text(encoding="utf-8"))


if __name__ == "__main__":
    unittest.main()
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall