Agent skills enablement kit

A small, tool-agnostic kit for rolling out AI assistants, coding agents, Agent Skills and MCP connectors inside an organisation: the counting is deterministic Python, the teaching and the judgment stay with people. Part of grok-bot-local-first (lib/enablement/), standard-library Python, MIT.

What is in it

Example run (synthetic data)

actionresult
skill-lint3 example skills: 2 clean, 1 with a non-portable name, no trigger, a missing file and a personal path
adoption2026-W42: overall 49 %; three functions below the 50 % target; one function flagged for spend out of line with usage
intake5 proposals: 1 fast-track, 3 to the forum (Legal items first), 1 rejected (restricted data, vendor outside the EU/EEA)

Architecture view: retrieval, skills and agents

For AI search and agent-driven flows over unstructured data, the kit adds a small strict-TypeScript module, lib/enablement/ts/skill-router.ts: selectCards() picks which Agent Skills and MCP tools to load for a request within a cost budget, and packContext() packs retrieved chunks into a context budget behind an interface that a vector or hybrid search can replace. ARCHITECTURE.md shows the full path: ingest and chunk → budgeted context → agent step → verification (schemas, grounding, secrets, trace evals) → human approval for anything that writes, spends or sends → adoption and cost KPIs.

cd lib/enablement/ts && npm install && npm test   # tsc --strict + node --test

Run it

python3 lib/enablement/enablement-kit.py --action skill-lint --dir path/to/skills
python3 lib/enablement/enablement-kit.py --action adoption --events usage.csv --headcount headcount.json
python3 lib/enablement/enablement-kit.py --action intake --proposals proposals.json
python3 -m unittest discover -s tests

Built with AI coding agents; deterministic tests gate the code. Markus Isaksson · GitHub