Engineering
Internals and contribution guidance for people working on this repo rather than consuming it. If you just want to install and use the skills, see the User Guide.
The repo's defining engineering constraint: bundled runtime needs no dependency
installation step. Some skills are instruction-only; bundled executable runtime uses
dependency-free Node ESM and the standard library, with provider CLI subprocesses
as the external execution boundary where needed. Canonical skill owners live
under src/skills/; TypeScript, Vitest, and bundling are developer tooling that
produce committed standalone and plugin installation units under skills/ and
plugins/.
The instruction-only seshtk-cli skill uses the external
@tkstang/session-toolkit CLI for execution. It checks this separately installed
prerequisite before use and does not automatically install it.
Contents
- Development — Set up the checkout, change a skill, and verify the relevant boundaries.
- Architecture — Shared transcript-core, Cursor collaboration reliability, and the canonical-owner to generated-installation-unit build contract.
- Documentation — Authoring, supported Markdown, navigation, and review guidance.
- Operations — CI, docs deployment, release evidence, and independent skill/plugin versioning.
- Decisions — Where durable architecture/product decisions are recorded.
- Repository Layout — Find canonical source, generated packages, and developer tooling.
- Contributing — Browse development and documentation contribution guidance.