Repository navigation
v0.2.0
qk is a small set of agent skills for Claude Code, Codex and omp: compare approaches, plan, implement with verification, debug, test, hand off between sessions, coordinate a second model, commit, and draft release notes. Every skill runs only when you call it by name (configured and checked on Claude Code, Codex and omp), states what it may and may not do, and ends its report with Done, Evidence, Not verified and Needs your decision. It extends the runtime you already use and does not replace it.
This is the first release published on GitHub. Start with the README and Getting started; the full list of skills and what each one returns is in the docs index. Earlier changes are in the changelog.
Changed
- qk-run follows your repository's commit convention. When most of the base branch's last 20 non-merge commits look like
type(scope): subject, the runner prefixes the commit and PR title with a type (feat,fix,docs,testorrefactor, taken from the plan title's first word) and lowercases the first letter, keeping acronyms such asREADMEorCI. A plan title that is already conventional is kept as written, and repositories without the convention see no change. (#8) - Documentation rewritten for a public audience. A new README explains what qk is and why it exists. The docs index is grouped into Start here, Guides and Reference, and dated test records now live on one Test evidence page so the guides stay current. Both English and Vietnamese are updated. (#7)
Removed
- Internal planning notes and a dated project summary that were not user documentation. (#7)
Upgrade notes
- If you run
qk-runon a repository that uses Conventional Commits, its commit and PR titles change from the bare plan title totype: subject. To choose the type yourself, give the plan a conventional title beforeapprove. - No skill instructions, invocation syntax or configuration changed.
Install or pin
git clone https://github.com/dakiquang/qk ~/src/qk
git -C ~/src/qk checkout v0.2.0Then link the skill folders into your runtime as described in Getting started. If you already have a clone, git -C ~/src/qk fetch --tags and check out v0.2.0.
Verified
- CI on each pull request passed:
scripts/validate.pyand the unit tests on Python 3.9 and 3.12, plus a gitleaks scan. - The new title rules are covered by unit tests, including merge commits in history and acronyms. The runner has not yet been run end to end with this new code.
- Runtime smoke results and their limits are recorded on the Test evidence page. Qwen Code is not yet checked.