agtmls 0.0.3__py3-none-any.whl

agtmls/__init__.py

@@ -0,0 +1,5 @@
+# SPDX-FileCopyrightText: 2026 Sebastien Rousseau
+# SPDX-License-Identifier: MIT
+"""AgtMLS — the universal agent skills registry."""
+
+__version__ = "0.0.3"

agtmls/__main__.py

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2026 Sebastien Rousseau
+# SPDX-License-Identifier: MIT
+"""Allow `python -m agtmls` alongside the `agtmls` console script."""
+
+import sys
+
+from agtmls.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

agtmls/_registry/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "author": {
+    "name": "Sebastien Rousseau"
+  },
+  "commands": "./commands",
+  "description": "The universal agent skills registry — polyglot engineering skills and system prompts, symlinked or installed into consumer repos.",
+  "homepage": "https://github.com/sebastienrousseau/agtmls",
+  "license": "MIT",
+  "name": "agtmls",
+  "skills": "./skills",
+  "version": "0.0.3"
+}

agtmls/_registry/CATALOG.md

@@ -0,0 +1,46 @@
+<!-- SPDX-FileCopyrightText: 2026 Sebastien Rousseau -->
+<!-- SPDX-License-Identifier: MIT -->
+<!-- Generated by scripts/generate-catalog.py; do not edit by hand. -->
+
+# AgtMLS Catalog
+
+Registry version: `0.0.3`
+Skills: `26`
+Commands: `1`
+
+## Skills
+
+| Name | Bundle | Tags | Path |
+|---|---|---|---|
+| `agent-loop-design` | `loops` | loops, validation | `skills/agent-loop-design` |
+| `ai-supply-chain-security` | `security` | release, security, validation | `skills/ai-supply-chain-security` |
+| `cross-language-port` | `general` | porting | `skills/cross-language-port` |
+| `handoff` | `general` | validation | `skills/handoff` |
+| `noyalib-architecture-contract` | `noyalib` | architecture, ci, noyalib | `skills/noyalib-architecture-contract` |
+| `noyalib-build-and-env` | `noyalib` | coverage, diagnostics, noyalib, qa | `skills/noyalib-build-and-env` |
+| `noyalib-change-control` | `noyalib` | ci, noyalib, release, security | `skills/noyalib-change-control` |
+| `noyalib-ci-and-release` | `noyalib` | ci, noyalib, release | `skills/noyalib-ci-and-release` |
+| `noyalib-config-and-flags` | `noyalib` | config, noyalib | `skills/noyalib-config-and-flags` |
+| `noyalib-coverage-campaign` | `noyalib` | coverage, debugging, noyalib | `skills/noyalib-coverage-campaign` |
+| `noyalib-debugging-playbook` | `noyalib` | debugging, noyalib, qa | `skills/noyalib-debugging-playbook` |
+| `noyalib-diagnostics-and-tooling` | `noyalib` | coverage, diagnostics, noyalib, validation | `skills/noyalib-diagnostics-and-tooling` |
+| `noyalib-docs-and-writing` | `noyalib` | architecture, ci, docs, noyalib, qa, release | `skills/noyalib-docs-and-writing` |
+| `noyalib-external-positioning` | `noyalib` | docs, noyalib, release, yaml | `skills/noyalib-external-positioning` |
+| `noyalib-failure-archaeology` | `noyalib` | ci, noyalib, validation | `skills/noyalib-failure-archaeology` |
+| `noyalib-research-frontier` | `noyalib` | noyalib, research, validation | `skills/noyalib-research-frontier` |
+| `noyalib-validation-and-qa` | `noyalib` | diagnostics, noyalib, qa, validation | `skills/noyalib-validation-and-qa` |
+| `pr-review-and-release` | `engineering` | ci, docs, engineering, release | `skills/pr-review-and-release` |
+| `receiving-code-review` | `general` | ci | `skills/receiving-code-review` |
+| `systematic-debugging` | `general` | debugging, qa | `skills/systematic-debugging` |
+| `test-driven-development` | `general` | qa | `skills/test-driven-development` |
+| `using-agtmls` | `general` | noyalib, porting, routing | `skills/using-agtmls` |
+| `verification-before-completion` | `general` | porting, qa, validation | `skills/verification-before-completion` |
+| `web-research-and-source-triage` | `web-reach` | ci, debugging, docs, research, validation, web-reach | `skills/web-research-and-source-triage` |
+| `writing-plans` | `general` | docs | `skills/writing-plans` |
+| `yaml-domain-reference` | `noyalib` | config, noyalib, yaml | `skills/yaml-domain-reference` |
+
+## Commands
+
+| Name | Description | Path |
+|---|---|---|
+| `agtmls` | Run the local AgtMLS registry health check. | `commands/agtmls.md` |

agtmls/_registry/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sebastien Rousseau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agtmls/_registry/checks.json

@@ -0,0 +1,62 @@
+{
+  "schema_version": 1,
+  "checks": [
+    "validate-skills.py",
+    "validate-spec-conformance.py",
+    "validate-licence-headers.py",
+    "validate-commands.py",
+    "validate-plugin-manifest.py",
+    "validate-packaging.py",
+    "validate-providers.py",
+    "validate-profiles.py",
+    "validate-templates.py",
+    "validate-doc-links.py",
+    "validate-json-files.py",
+    "validate-python-scripts.py",
+    "validate-shell-syntax.py",
+    "validate-secrets.py",
+    "validate-gitignore.py",
+    "validate-cli-surface.py",
+    "validate-system-prompts.py",
+    "check-skill-collisions.py",
+    "validate-eval-cases.py",
+    "run-trigger-evals.py",
+    "run-behavioral-evals.py",
+    "validate-skill-metadata.py",
+    "sync-skill-frontmatter.py --check",
+    "generate-plugin-manifests.py --check",
+    "generate-skill-index.py --check",
+    "generate-catalog.py --check",
+    "generate-docs-site.py --check",
+    "generate-agent-card.py --check",
+    "generate-mcp-resources.py --check",
+    "generate-sbom.py --check",
+    "generate-provenance.py --check",
+    "validate-generated-artifacts.py",
+    "validate-docs-site.py",
+    "validate-governance.py",
+    "validate-skill-index.py",
+    "validate-lifecycle.py",
+    "validate-version-policy.py",
+    "validate-release.py",
+    "release-check.py",
+    "smoke-release-pack.py",
+    "smoke-next-version.py",
+    "smoke-bump-version-check.py",
+    "smoke-release-dry-run.py",
+    "smoke-evolve-evidence.py",
+    "smoke-provider-install.py",
+    "smoke-live-providers.py",
+    "smoke-install.py",
+    "smoke-install-profiles.py",
+    "smoke-cli.py",
+    "smoke-export.py",
+    "smoke-import.py",
+    "smoke-proposal.py",
+    "smoke-scaffold.py",
+    "run-unit-tests.py",
+    "bench.py",
+    "validate-check-manifest.py",
+    "agtmls-doctor.py"
+  ]
+}

agtmls/_registry/commands/README.md

@@ -0,0 +1,10 @@
+<!-- SPDX-FileCopyrightText: 2026 Sebastien Rousseau -->
+<!-- SPDX-License-Identifier: MIT -->
+
+# commands/
+
+Slash-command bundles for agent clients that support a command directory.
+
+This directory is intentionally present so `.claude-plugin/plugin.json` can
+declare a stable commands path. Add command files here when a workflow should be
+invoked explicitly instead of discovered through a `SKILL.md` description.

agtmls/_registry/commands/agtmls.md

@@ -0,0 +1,16 @@
+---
+description: Run the local AgtMLS registry health check.
+license: MIT
+---
+
+Run from the AgtMLS checkout:
+
+```sh
+python3 scripts/agtmls.py status
+```
+
+For a consumer repo, include the target agent layout:
+
+```sh
+python3 scripts/agtmls.py status --target /path/to/repo --agent codex --skills-only
+```

agtmls/_registry/evals/README.md

@@ -0,0 +1,46 @@
+<!-- SPDX-FileCopyrightText: 2026 Sebastien Rousseau -->
+<!-- SPDX-License-Identifier: MIT -->
+
+# evals/ — trigger-routing checks
+
+Deterministic, zero-token checks that each skill's `description` actually
+attracts its own prompts and repels others — the early-warning system for
+description drift as the catalog grows. Run by `scripts/run-trigger-evals.py`
+in CI.
+
+## Case format (`cases/<skill-name>.json`)
+
+```json
+{
+  "skill": "noyalib-ci-and-release",
+  "positive": ["prompts that SHOULD route to this skill"],
+  "negative": ["prompts that should NOT rank this skill #1"]
+}
+```
+
+- **positive** — each prompt must rank the owning skill in the top-K
+  (TF-IDF cosine of the prompt against every skill description).
+- **negative** — each prompt must NOT rank the owning skill #1.
+
+This is a cheap *proxy* for the model's real routing judgment; it catches a
+description that has stopped matching its own obvious prompts, not subtle
+preference. Add a case file when you add a skill.
+
+## Forward-compatible schema (behavioural evals)
+
+For future behavioural evals (grading an execution trace, not just routing),
+shape richer cases to Anthropic's skill-creator `evals.json` schema so
+external tooling works unmodified:
+
+```json
+{ "id": "…", "prompt": "…", "expected_output": "…", "expectations": ["…"] }
+```
+
+The token-spending runner for those is intentionally deferred — the routing
+proxy here is the free, always-on gate.
+
+## Coverage
+
+Starter cases cover a representative subset of the noyalib bundle. Filling in
+one case file per skill is a standing task; every new skill SHOULD ship with
+its case file.

agtmls/_registry/evals/behavioral/README.md

@@ -0,0 +1,27 @@
+<!-- SPDX-FileCopyrightText: 2026 Sebastien Rousseau -->
+<!-- SPDX-License-Identifier: MIT -->
+
+# evals/behavioral/
+
+Deterministic behavioral smoke checks for skill contracts. These are not LLM
+grades; they assert that a skill still contains the load-bearing instructions,
+references, and forbidden-shortcut fences that make the workflow safe to run.
+
+Case files live in `cases/*.json`:
+
+```json
+{
+  "skill": "cross-language-port",
+  "requires": {
+    "skill_contains": ["golden-I/O corpus"],
+    "files_exist": ["reference.md"]
+  },
+  "forbids": {
+    "skill_contains": ["eyeball equivalence"]
+  }
+}
+```
+
+Use these for invariants that should survive rewrites. Routing belongs in
+`evals/cases/`; execution-quality checks that require a model remain a future
+runner.

agtmls/_registry/evals/behavioral/cases/agent-loop-design.json

@@ -0,0 +1,19 @@
+{
+  "forbids": {
+    "skill_contains": [
+      "ignore safety_policy"
+    ]
+  },
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "reference_contains": [
+      "Required Outputs"
+    ],
+    "skill_contains": [
+      "## Workflow"
+    ]
+  },
+  "skill": "agent-loop-design"
+}

agtmls/_registry/evals/behavioral/cases/ai-supply-chain-security.json

@@ -0,0 +1,19 @@
+{
+  "forbids": {
+    "skill_contains": [
+      "ignore safety_policy"
+    ]
+  },
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "reference_contains": [
+      "Required Outputs"
+    ],
+    "skill_contains": [
+      "## Workflow"
+    ]
+  },
+  "skill": "ai-supply-chain-security"
+}

agtmls/_registry/evals/behavioral/cases/cross-language-port.json

@@ -0,0 +1,27 @@
+{
+  "skill": "cross-language-port",
+  "requires": {
+    "files_exist": [
+      "reference.md",
+      "harness/port-check.sh",
+      "harness/golden-diff.sh"
+    ],
+    "skill_contains": [
+      "Behaviour is preserved exactly",
+      "golden-I/O corpus",
+      "harness/port-check.sh <target-lang> <files>",
+      "ad-hoc string-parse across a language boundary"
+    ],
+    "reference_contains": [
+      "Idiom-mapping matrix",
+      "Per-language porting notes",
+      "Data-boundary"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "looks right is enough",
+      "skip equivalence"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/handoff.json

@@ -0,0 +1,24 @@
+{
+  "skill": "handoff",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "without asking you a question",
+      "State of the tree",
+      "Dead ends",
+      "next action"
+    ],
+    "reference_contains": [
+      "Template",
+      "Multi-agent and cross-tool handoff"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "should be straightforward",
+      "omit the dead ends"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-architecture-contract.json

@@ -0,0 +1,23 @@
+{
+  "skill": "noyalib-architecture-contract",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "forbid(unsafe_code)",
+      "loader parity",
+      "value_target_bypass"
+    ],
+    "reference_contains": [
+      "stream_eligible",
+      "NoSpanLoader"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "allow unsafe",
+      "loader parity is optional"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-build-and-env.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-build-and-env",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "fresh clone",
+      "cargo build",
+      "Apple-Silicon",
+      "Miri"
+    ],
+    "reference_contains": [
+      "Extra tooling inventory",
+      "cargo install"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "ignore MSRV",
+      "run from any directory"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-change-control.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-change-control",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "classify",
+      "forbid(unsafe_code)",
+      "Never",
+      "release readiness"
+    ],
+    "reference_contains": [
+      "complete 9-row taxonomy",
+      "Same-session green"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "--no-verify` is allowed",
+      "[skip ci] is allowed"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-ci-and-release.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-ci-and-release",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "cache-poisoning doctrine",
+      "tag-driven release flow",
+      "cargo-vet",
+      "caller-permissions"
+    ],
+    "reference_contains": [
+      "release.yml",
+      "crates-io"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "--no-verify is acceptable",
+      "[skip ci]"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-config-and-flags.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-config-and-flags",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "ParserConfig",
+      "SerializerConfig",
+      "Cargo feature",
+      "strict()"
+    ],
+    "reference_contains": [
+      "ParserConfig",
+      "Cargo feature matrix"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "string replace Cargo.toml",
+      "skip parity"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-coverage-campaign.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-coverage-campaign",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "96 fn / 94 lines / 93 regions",
+      "98 %",
+      "baseline",
+      "wrong turns"
+    ],
+    "reference_contains": [
+      "coverage-gap-report",
+      "Known wrong paths"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "weakening thresholds is allowed",
+      "assert-free coverage tests are enough"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-debugging-playbook.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-debugging-playbook",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "Symptom-driven triage",
+      "from_str::<Value>",
+      "NoSpanLoader",
+      "budget"
+    ],
+    "reference_contains": [
+      "routing-full",
+      "symptom"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "guess first",
+      "ignore loader parity"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-diagnostics-and-tooling.json

@@ -0,0 +1,25 @@
+{
+  "skill": "noyalib-diagnostics-and-tooling",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "Measure instead of eyeball",
+      "coverage",
+      "Miri",
+      "criterion",
+      "cargo-fuzz"
+    ],
+    "reference_contains": [
+      "bench",
+      "libfuzzer"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "claim without evidence is fine",
+      "measurement is optional"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-docs-and-writing.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-docs-and-writing",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "README",
+      "CHANGELOG",
+      "SPDX",
+      "ADR"
+    ],
+    "reference_contains": [
+      "release-notes",
+      "SPDX"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "docs can follow later",
+      "omit SPDX"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-external-positioning.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-external-positioning",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "public",
+      "competitor",
+      "claiming rules",
+      "re-verified"
+    ],
+    "reference_contains": [
+      "Ecosystem",
+      "claim"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "unverified uniqueness",
+      "benchmark headline without"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-failure-archaeology.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-failure-archaeology",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "settled battles",
+      "BEFORE",
+      "symptom",
+      "what NOT to retry"
+    ],
+    "reference_contains": [
+      "Root cause",
+      "Status"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "retry every old fix",
+      "history is irrelevant"
+    ]
+  }
+}

agtmls/_registry/evals/behavioral/cases/noyalib-research-frontier.json

@@ -0,0 +1,24 @@
+{
+  "skill": "noyalib-research-frontier",
+  "requires": {
+    "files_exist": [
+      "reference.md"
+    ],
+    "skill_contains": [
+      "candidate",
+      "YAML-spec leadership",
+      "falsifiable",
+      "OPEN"
+    ],
+    "reference_contains": [
+      "hypothesis",
+      "Result-when"
+    ]
+  },
+  "forbids": {
+    "skill_contains": [
+      "guaranteed roadmap",
+      "is a guaranteed roadmap"
+    ]
+  }
+}