git clone https://github.com/TalonT-Org/AutoSkillit.git
cd AutoSkillit
uv pip install -e '.[dev]'
pre-commit install
autoskillit install
Developers work on
main. Thestablebranch is the release branch for end users.
task test-all
Tests run in parallel via pytest-xdist (-n 4). All tests must be safe for
parallel execution. Never use pytest directly — always use task test-all
(or task test-check for CI/automation).
Hooks run automatically on commit: ruff format, ruff check, mypy, uv lock check, gitleaks secret scanning, doc count accuracy.
pre-commit run --all-files
The codebase uses strict import layering enforced by import-linter:
| Layer | Package | May import |
|---|---|---|
| L0 | core/ |
Nothing (foundation) |
| L1 | config/, pipeline/, execution/, workspace/ |
L0 only |
| L2 | recipe/, migration/ |
L0, L1 (workspace only for recipe) |
| L3 | server/, cli/ |
Everything |
When bumping the version, update three locations:
pyproject.toml—version = "X.Y.Z".claude-plugin/plugin.json—"version": "X.Y.Z"- Run
uv lock - Search tests for hardcoded version strings and update them
- Session Diagnostics — Process-level diagnostic logging for headless sessions
- End-Turn Hazards — Stochastic failure modes in skill authoring and how to prevent them