v0.5.3 — kpi_gate, Skill anatomy docs, and example smoke tests

Skillware 0.5.3 ships a new monitoring skill for deterministic business-KPI gating, consolidates contributor and catalog docs under Skill anatomy, adds CI smoke coverage for offline examples, and hardens the test harness against operator global config.

Install: pip install skillware==0.5.3 or just pip install skillware

Update from 0.5.2: pip install -U skillware — no breaking framework API changes; new bundled skill and doc vocabulary only.

---

Added

monitoring/kpi_gate v0.1.0 (#317, #318)

New bundled monitoring skill: deterministic business-KPI gate — {metrics, policy, benchmarks?} → findings[].

• Evaluates a metrics snapshot against an operator-maintained policy charter (versioned YAML) and optional versioned benchmark data
• Severities: error (block), warning (surface), and honest insufficient_data refusals with reason codes — never backfilled
• Fail-closed contract errors from a closed registry; stdlib-only validation (requirements: [])
• Pure execute(): no network, identical input → identical output
• Demo benchmark data under kb/benchmarks_demo.json
• Catalog: docs/skills/kpi_gate.md
• Extra: pip install "skillware[monitoring_kpi_gate]"

from skillware.core.loader import SkillLoader

bundle = SkillLoader.load_skill("monitoring/kpi_gate")
skill = bundle["class"]()
# Pass metrics snapshot + policy charter (+ optional benchmarks)
result = skill.execute({...})

Complements monitoring/token_limiter (resource-side) with business-metric monitoring for agent loops that need policy gates before acting.

Example smoke tests (#237, #315)

• tests/test_examples_smoke.py — CI runs local-execute offline demos under examples/ without live API keys
• Catches import regressions and SkillLoader dispatch errors early
• docs/TESTING.md documents the smoke layer and skip policy for live provider loops

---

Changed

Skill anatomy vocabulary (#319)

Docs now use a single bundle vocabulary everywhere contributors and operators read them:

• Contract, Effect, Directive, Assurance, Interface
• Optional Corpus, Reference, Presentation

Touched: docs/introduction.md, README Mission, CONTRIBUTING.md, provider guides, all catalog pages, contributor templates. Anchor: Skill anatomy.

Issuer policy alignment (#295, #316)

• Documented issuer.org design-ownership policy for registry skills
• Aligned ARPA-driven skills (prompt_injection_firewall, bg_remover, novelty_extractor) and catalog Issuer lines
• Backfilled Skill history rows on affected catalog pages

---

Fixed

• README Mermaid — How it works diagram uses stadium node AnyHost([Any Host]) for the third block; rectangle [Any Host] breaks GitHub's renderer (same pattern as pre-#319 ([Logical Systems]))
• Tests — pytest tests/ isolated from operator global config.yaml via autouse SKILLWARE_CONFIG_DIR in tests/conftest.py; configured-mode discovery and loader coverage alongside legacy-order tests (#302)

---

What's possible today

Capability	How
Load KPI gate	SkillLoader.load_skill("monitoring/kpi_gate")
Per-skill install	pip install "skillware[monitoring_kpi_gate]"
Read bundle roles	Introduction — Skill anatomy
Run offline demos in CI	pytest tests/test_examples_smoke.py (included in full test suite)
Full registry + framework	pip install "skillware[all]" or pip install -e ".[dev,all]" for development

---

Upgrade notes

• No breaking CLI or loader API changes since 0.5.2
• New skill: monitoring/kpi_gate is bundled in the wheel — available after upgrade without a local skills/ tree
• Docs only: Mission/README/catalog now say Contract/Effect/Directive instead of Logic/Cognition/Governance — filenames unchanged
• Citing: Zenodo concept DOI 10.5281/zenodo.21552745 stays stable; record Skillware 0.5.3 for reproducibility (CITATION.cff updated)

---

Full changelog

CHANGELOG.md — 0.5.3

---

Contributors

Thanks to everyone who landed work since v0.5.2:

• @mrmasa88 — monitoring/kpi_gate skill bundle (#318)
• @tusharjamunkar — CI smoke tests for offline examples (#315)
• @rosspeili — Skill anatomy docs (#319); issuer policy alignment (#316); pytest config isolation (#324); README Mermaid fix; release cut

---

Citation

Zenodo concept DOI: 10.5281/zenodo.21552745 — record Skillware v0.5.3 for reproducibility (CITATION.cff updated).