You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(brand): Present the public name as Skill-Leaf
Changes:
- Rename public product references to Skill-Leaf
- Point package metadata and installation guidance at the renamed repository
- Retain skillleaf for the CLI, crate, schemas and code identifiers
Reason: Keep the leaf concept visible without breaking conventional package or command naming.
Modified: Cargo.toml, README.md, LICENSE, COMMERCIAL-LICENCE.md, CONTRIBUTOR-LICENCE-AGREEMENT.md, TRADEMARKS.md, SECURITY.md, skills/skillleaf/SKILL.md, .github/ISSUE_TEMPLATE/bug_report.yml
Copy file name to clipboardExpand all lines: COMMERCIAL-LICENCE.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,10 @@
1
1
# Commercial licensing
2
2
3
-
Skillleaf is source-available under the MIT License with the Commons Clause License Condition v1.0.
3
+
Skill-Leaf is source-available under the MIT License with the Commons Clause License Condition v1.0.
4
4
5
-
Individuals and businesses may use, modify and run Skillleaf, including for internal commercial work. You may also include it in a larger product where Skillleaf is not substantially the product's value.
5
+
Individuals and businesses may use, modify and run Skill-Leaf, including for internal commercial work. You may also include it in a larger product where Skill-Leaf is not substantially the product's value.
6
6
7
-
The public licence does not permit selling Skillleaf itself, a lightly modified substitute, or a paid service whose value derives entirely or substantially from Skillleaf. Those uses require a separate commercial licence.
7
+
The public licence does not permit selling Skill-Leaf itself, a lightly modified substitute, or a paid service whose value derives entirely or substantially from Skill-Leaf. Those uses require a separate commercial licence.
8
8
9
9
Commercial licensing is available through [Codebridge.com.au](https://codebridge.com.au). The public repository does not grant rights to the Codebridge name, branding, private skill catalogue, customer material or commercial Codebridge toolset.
Copy file name to clipboardExpand all lines: CONTRIBUTOR-LICENCE-AGREEMENT.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Contributor licence agreement
2
2
3
-
We welcome fixes, tests, documentation and well-bounded improvements. We also use Skillleaf as part of commercial Codebridge products, so accepted contributions need clear licensing terms.
3
+
We welcome fixes, tests, documentation and well-bounded improvements. We also use Skill-Leaf as part of commercial Codebridge products, so accepted contributions need clear licensing terms.
4
4
5
5
Submitting a pull request means you confirm all of the following:
Copy file name to clipboardExpand all lines: README.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
-
# Skillleaf
1
+
# Skill-Leaf
2
2
3
3
Most coding agents load every available skill description before the work begins. Some load entire skill bodies. It works, but it can spend hundreds of thousands of tokens explaining capabilities the agent never uses.
4
4
5
-
Skillleaf keeps those files on your computer. A small Rust binary builds a verified catalogue, selects the few entries relevant to the task, follows their linked references, then reads the selected bodies in one call. No model. No remote service. No MCP server.
5
+
Skill-Leaf keeps those files on your computer. A small Rust binary builds a verified catalogue, selects the few entries relevant to the task, follows their linked references, then reads the selected bodies in one call. No model. No remote service. No MCP server.
6
6
7
-
We built Skillleaf for [Codebridge.com.au](https://codebridge.com.au) because our own agents had reached hundreds of skills and commands. We are releasing the router so other developers can test it, improve it and spend fewer tokens on repeated setup.
7
+
We built Skill-Leaf for [Codebridge.com.au](https://codebridge.com.au) because our own agents had reached hundreds of skills and commands. We are releasing the router so other developers can test it, improve it and spend fewer tokens on repeated setup.
8
8
9
9
## What it changes
10
10
11
-
Without a router, an agent host may place the complete skill library in the prompt. Skillleaf leaves the library on disk and returns a small receipt:
11
+
Without a router, an agent host may place the complete skill library in the prompt. Skill-Leaf leaves the library on disk and returns a small receipt:
12
12
13
13
1.`index` creates an ordered, hash-verified catalogue.
14
14
2.`resolve` selects a bounded skill and command dependency closure.
@@ -19,7 +19,7 @@ The ordered index uses Rust's B-tree maps for reproducible output. The speed com
19
19
20
20
## Measured result
21
21
22
-
We tested Skillleaf against one real local library with 382 entries and 3.34 MB of Markdown. A representative pull request review selected 101 KB, leaving about 3.24 MB out of the prompt. Using a rough four-bytes-per-token estimate, that avoided approximately 810,000 input tokens for that request.
22
+
We tested Skill-Leaf against one real local library with 382 entries and 3.34 MB of Markdown. A representative pull request review selected 101 KB, leaving about 3.24 MB out of the prompt. Using a rough four-bytes-per-token estimate, that avoided approximately 810,000 input tokens for that request.
23
23
24
24
Across 20 warm runs on an Apple Silicon development machine, resolution averaged 4.8 ms and hydration of eight bodies averaged 4.3 ms. Rebuilding the full catalogue averaged 96.6 ms across 10 runs.
25
25
@@ -58,18 +58,18 @@ skillleaf --help
58
58
After the repository is public, Cargo can install the same source directly:
Skillleaf does not change Claude Code, Codex, OpenCode or your skill folders during installation. That is deliberate. Migration stays visible and reversible.
64
+
Skill-Leaf does not change Claude Code, Codex, OpenCode or your skill folders during installation. That is deliberate. Migration stays visible and reversible.
65
65
66
66
## Migrate an existing library safely
67
67
68
68
Do not delete your current skills or commands. Back them up, copy them into a host-neutral library, verify the copy, then remove the originals from the host's discovery path only after a fresh session proves the router works.
69
69
70
70
### macOS and Linux
71
71
72
-
This example uses Claude Code folders. Repeat the copy for any other host-specific library you want Skillleaf to route.
72
+
This example uses Claude Code folders. Repeat the copy for any other host-specific library you want Skill-Leaf to route.
73
73
74
74
```sh
75
75
skillleaf_root="$HOME/.local/share/skillleaf"
@@ -96,12 +96,12 @@ SKILLLEAF_CATALOG="$skillleaf_root/catalog.json" skillleaf doctor
96
96
97
97
Run the command-line verification below before changing the host. For cutover, move the original active skill directory to a recoverable name outside the host's discovery path, create a new empty active directory, then copy `skills/skillleaf/SKILL.md` into a `skillleaf` folder beneath it. Start a clean agent session and confirm it follows the router. Restore the renamed directory immediately if it does not.
98
98
99
-
Host-native slash commands are a separate boundary. Moving a command file out of the host's discovery path may remove that `/command` from the host interface. Leave commands that must remain directly invokable in their native directory; Skillleaf can route their instruction bodies, but it does not register host UI commands.
99
+
Host-native slash commands are a separate boundary. Moving a command file out of the host's discovery path may remove that `/command` from the host interface. Leave commands that must remain directly invokable in their native directory; Skill-Leaf can route their instruction bodies, but it does not register host UI commands.
@@ -147,7 +147,7 @@ Rollback is simply restoring the backed-up folders to the host's discovery path
147
147
148
148
## Expected benefit
149
149
150
-
Skillleaf helps when the host would otherwise preload a large skill and command library. In that shape, users should see:
150
+
Skill-Leaf helps when the host would otherwise preload a large skill and command library. In that shape, users should see:
151
151
152
152
- smaller session-start prompts because only the router description is always visible;
153
153
- lower input-token use because irrelevant bodies stay on disk;
@@ -157,7 +157,7 @@ Skillleaf helps when the host would otherwise preload a large skill and command
157
157
- one catalogue shared across Claude Code, Codex, OpenCode, CI and custom agent runners;
158
158
- local usage evidence showing which entries earn maintenance and which never get hydrated.
159
159
160
-
The host must honour the router workflow for these savings to appear. Skillleaf cannot stop a host from preloading files that remain in its own discovery directory. Measure a clean session before and after migration rather than assuming the result.
160
+
The host must honour the router workflow for these savings to appear. Skill-Leaf cannot stop a host from preloading files that remain in its own discovery directory. Measure a clean session before and after migration rather than assuming the result.
161
161
162
162
## Supported layout
163
163
@@ -174,7 +174,7 @@ dependencies:
174
174
---
175
175
```
176
176
177
-
Skillleaf deliberately supports this small frontmatter surface. The parser is line-based, deterministic and tolerant of common human-written descriptions that strict YAML parsers reject.
177
+
Skill-Leaf deliberately supports this small frontmatter surface. The parser is line-based, deterministic and tolerant of common human-written descriptions that strict YAML parsers reject.
178
178
179
179
Relative Markdown links and explicit `dependencies` form the verified chain. Arbitrary `@file` references are not parsed in version 0.1.0; convert important ones to Markdown links or explicit selectors so missing references fail during indexing.
180
180
@@ -187,11 +187,11 @@ Relative Markdown links and explicit `dependencies` form the verified chain. Arb
187
187
- Source collisions and missing dependencies are errors.
188
188
- Prompts, code and credentials stay on the computer.
189
189
- Optional usage counts store selectors, hashes, counts and timestamps locally. They never store prompts or task text.
190
-
-Skillleaf reads instructions. It does not execute bundled scripts.
190
+
-Skill-Leaf reads instructions. It does not execute bundled scripts.
191
191
192
192
## Deliberate limits
193
193
194
-
Skillleaf does not install skills, modify agent settings or infer private workflow policy. It does not use fuzzy matching, embeddings or an LLM. Deterministic lexical routing is the dependable first path; future rerankers can sit above it without weakening hashes, containment or explicit dependencies.
194
+
Skill-Leaf does not install skills, modify agent settings or infer private workflow policy. It does not use fuzzy matching, embeddings or an LLM. Deterministic lexical routing is the dependable first path; future rerankers can sit above it without weakening hashes, containment or explicit dependencies.
195
195
196
196
## Use it with an agent
197
197
@@ -212,8 +212,8 @@ Counting happens only after a body passes hash and containment checks. Concurren
212
212
213
213
## Licence
214
214
215
-
Skillleaf is source-available under the [MIT License with the Commons Clause License Condition v1.0](LICENSE). It is not OSI open source because selling substantially the same software is restricted.
215
+
Skill-Leaf is source-available under the [MIT License with the Commons Clause License Condition v1.0](LICENSE). It is not OSI open source because selling substantially the same software is restricted.
216
216
217
-
Individuals and businesses may use, modify and run Skillleaf, including for internal commercial work. Selling Skillleaf itself, a lightly modified substitute, or a paid service whose value derives substantially from Skillleaf requires a [separate commercial licence](COMMERCIAL-LICENCE.md).
217
+
Individuals and businesses may use, modify and run Skill-Leaf, including for internal commercial work. Selling Skill-Leaf itself, a lightly modified substitute, or a paid service whose value derives substantially from Skill-Leaf requires a [separate commercial licence](COMMERCIAL-LICENCE.md).
218
218
219
219
Contributions are welcome under the [contribution terms](CONTRIBUTOR-LICENCE-AGREEMENT.md). Names and branding remain subject to the [trademark policy](TRADEMARKS.md).
Copy file name to clipboardExpand all lines: SECURITY.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,4 +2,4 @@
2
2
3
3
Please report vulnerabilities privately through GitHub's security-advisory feature after the repository is published. Do not include credentials or private skill bodies in a public issue.
4
4
5
-
Skillleaf treats catalogs and skill libraries as untrusted local input. A security report is especially useful when it demonstrates path escape, symlink traversal, hash-verification bypass, unbounded resource use, or unintended execution.
5
+
Skill-Leaf treats catalogues and skill libraries as untrusted local input. A security report is especially useful when it demonstrates path escape, symlink traversal, hash-verification bypass, unbounded resource use, or unintended execution.
Copy file name to clipboardExpand all lines: TRADEMARKS.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,6 +2,6 @@
2
2
3
3
The software licence covers code. It does not grant rights to the names, logos or branding of Codebridge, Codebridge.com.au or related commercial products.
4
4
5
-
You may use the Skillleaf name to identify an unchanged copy, a compatible integration or a factual reference to this project. Do not imply endorsement, partnership or official status for a modified version, hosted service or commercial product.
5
+
You may use the Skill-Leaf name to identify an unchanged copy, a compatible integration or a factual reference to this project. Do not imply endorsement, partnership or official status for a modified version, hosted service or commercial product.
6
6
7
-
Forks may describe themselves as "based on Skillleaf" when that statement is accurate and the original source is credited.
7
+
Forks may describe themselves as "based on Skill-Leaf" when that statement is accurate and the original source is credited.
Copy file name to clipboardExpand all lines: skills/skillleaf/SKILL.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,9 @@
2
2
name: skillleaf
3
3
description: Route large local agent skill and command libraries without loading every body into context. Use when starting a task, selecting skills, reducing skill tokens, or hydrating several related instructions.
4
4
---
5
-
# Skillleaf router
5
+
# Skill-Leaf router
6
6
7
-
Use the local Skillleaf binary before loading capability instructions.
7
+
Use the local Skill-Leaf binary before loading capability instructions.
8
8
9
9
1. Summarise the current task in one concrete sentence.
0 commit comments