README.md

Chunk Your Skills

Rust-first library for decomposing agent SKILL.md files into page-indexed nodes and recomposing skinny skills — only the sections you select.

This repository is the chunk-your-skills SDK monorepo. The former clear-your-tools proxy application layer has been removed; use clear-your-tools for the MCP tool-gating proxy.

What it does

1. Chunk/Decompose — parse SKILL.md into a tree of nodes (frontmatter, preamble, heading sections).
2. Cache — write metadata.json, nodes/page_index.json, and nodes/n{id}.md under a catalog directory.
3. Recompose — rebuild a skinny SKILL.md from selected node IDs.

Packages C/Go/Rust/TypeScript/Python

Published packages

chunk-your-skills (crates.io)	Rust library and CLI
chunk-your-skills (PyPI)	Python SDK (import chunk_your_skills)
chunk-your-skills (npm)	TypeScript SDK
libchunk_your_skills (Release)	C library via CMake / build-c-lib.sh
sdk/go (pkg.go.dev)	Go SDK via cgo (import chunkyourskills)

Quick start

Install the CLI:

cargo install chunk-your-skills

Or build locally: cargo build -p chunk-your-skills --release.

Library installs:

cargo add chunk-your-skills
pip install chunk-your-skills
npm install chunk-your-skills

Try the bundled walkthrough — decompose a sample skill, then recompose skinny variants:

./examples/decompose.sh
export PATH="$PWD/target/release:$PATH"
./examples/recompose.sh

See examples/README.md for node IDs, output paths, and CLI flags.

SDKs

SDK	Path	Docs
Python	sdk/python	README
TypeScript	sdk/typescript	README
Go	sdk/go	README
C	sdk/c	README
Rust	src	README

Development

See DEV.md for local workflow, version sync, and publish notes.

License

Apache-2.0 — see LICENSE.