ctl-release
About
The ctl-release skill updates and rebuilds spikectl or ctl CLI packages in the monorepo when source code changes occur. It handles compilation, Nix builds, and binary testing to ensure CLI tools are properly updated after refactoring. Developers use it to maintain distribution-ready binaries with automated validation checks.
Quick Install
Claude Code
Recommended/plugin add https://github.com/majiayu000/claude-skill-registrygit clone https://github.com/majiayu000/claude-skill-registry.git ~/.claude/skills/ctl-releaseCopy and paste this command in Claude Code to install this skill
Documentation
Option: CTL Release
Initiation (I)
Invoke when:
- Source code changed in
packages/spikectl/orpackages/ctl/ - Need to rebuild CLI binaries for Nix distribution
- Updating CLI tools after refactoring
Observation Space (Y)
| Observable | How to Check |
|---|---|
| Source modified | git status packages/{spikectl,ctl}/src/ |
| Binary stale | Compare bin/ mtime vs src/ mtime |
| TypeScript valid | bunx tsc --noEmit |
Action Space (U)
| Action | Command | From Directory |
|---|---|---|
compile | bun build --compile --minify src/index.ts --outfile bin/<name> | packages/<pkg>/ |
build-nix | nix build '.?dir=packages/tmnl#<pkg>' | repo root |
test-binary | ./result/bin/<pkg> --version | repo root |
update-lock | nix flake update <pkg> | packages/tmnl/ |
Policy (π)
STATE: source_changed ∧ ¬binary_updated
→ ACTION: compile
STATE: binary_updated ∧ need_nix_build
→ ACTION: build-nix
STATE: flake_deps_changed
→ ACTION: update-lock → build-nix
STATE: build_complete
→ ACTION: test-binary → TERMINATE
Termination (β)
| Condition | Exit |
|---|---|
./result/bin/<pkg> --version succeeds | SUCCESS |
| TypeScript errors | FAIL: fix errors |
| Nix build fails | FAIL: check flake.nix |
Q-Heuristics
| Situation | Guidance |
|---|---|
| Source-only changes | Skip nix flake update - path: inputs evaluate live |
| New dependencies in flake.nix | Must run nix flake update <pkg> |
| Binary size changed significantly | Verify correct bundling |
Constraints
- □(compile_before_nix_build) — Always compile before Nix build
- □(test_after_build) — Always verify binary works after build
- ◇(version_incremented) — Eventually bump version for releases
Commands
Quick Rebuild
cd packages/spikectl
bun build --compile --minify src/index.ts --outfile bin/spikectl
Full Release
cd packages/spikectl
bun build --compile --minify src/index.ts --outfile bin/spikectl
git add bin/spikectl
git commit -m "build(spikectl): v0.x.x"
cd ../..
nix build '.?dir=packages/tmnl#spikectl'
./result/bin/spikectl --version
DevShell Access
nix develop '.?dir=packages/tmnl#tmnl-ctl'
# Now spikectl and ctl are in PATH
Why No Flake Update for Source Changes?
The tmnl flake uses path: inputs:
spikectl = { url = "path:../spikectl"; }
No hash lock → changes picked up on rebuild.
GitHub Repository
Related Skills
content-collections
MetaThis skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.
creating-opencode-plugins
MetaThis skill provides the structure and API specifications for creating OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It offers implementation patterns for JavaScript/TypeScript modules that intercept and extend the AI assistant's lifecycle. Use it when you need to build event-driven plugins for monitoring, custom handling, or extending OpenCode's capabilities.
langchain
MetaLangChain is a framework for building LLM applications using agents, chains, and RAG pipelines. It supports multiple LLM providers, offers 500+ integrations, and includes features like tool calling and memory management. Use it for rapid prototyping and deploying production systems like chatbots, autonomous agents, and question-answering services.
Algorithmic Art Generation
MetaThis skill helps developers create algorithmic art using p5.js, focusing on generative art, computational aesthetics, and interactive visualizations. It automatically activates for topics like "generative art" or "p5.js visualization" and guides you through creating unique algorithms with features like seeded randomness, flow fields, and particle systems. Use it when you need to build reproducible, code-driven artistic patterns.
