Skip to content

Commit c5ca591

Browse files
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
1 parent 7a5538e commit c5ca591

9 files changed

Lines changed: 30 additions & 30 deletions

File tree

.github/ISSUE_TEMPLATE/bug_report.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ labels: [bug]
55
body:
66
- type: markdown
77
attributes:
8-
value: Thanks for helping us make Skillleaf more dependable. Do not include private skill bodies, credentials or customer material.
8+
value: Thanks for helping us make Skill-Leaf more dependable. Do not include private skill bodies, credentials or customer material.
99
- type: input
1010
id: version
1111
attributes:
12-
label: Skillleaf version
12+
label: Skill-Leaf version
1313
placeholder: skillleaf 0.1.0
1414
validations:
1515
required: true

COMMERCIAL-LICENCE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Commercial licensing
22

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.
44

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.
66

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.
88

99
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.
1010

CONTRIBUTOR-LICENCE-AGREEMENT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributor licence agreement
22

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.
44

55
Submitting a pull request means you confirm all of the following:
66

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description = "Local-first deterministic routing and lazy hydration for AI agent
66
license-file = "LICENSE"
77
documentation = "https://docs.rs/skillleaf"
88
homepage = "https://codebridge.com.au"
9-
repository = "https://github.com/derek-codebridge/skillleaf"
9+
repository = "https://github.com/derek-codebridge/Skill-Leaf"
1010
keywords = ["ai", "agents", "skills", "cli", "context"]
1111
categories = ["command-line-utilities", "development-tools"]
1212

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ whose value derives, entirely or substantially, from the functionality of the
3737
Software. Any licence notice or attribution required by the License must also
3838
include this Commons Clause License Condition notice.
3939

40-
Software: Skillleaf
40+
Software: Skill-Leaf
4141

4242
License: MIT License
4343

README.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
# Skillleaf
1+
# Skill-Leaf
22

33
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.
44

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.
66

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.
88

99
## What it changes
1010

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:
1212

1313
1. `index` creates an ordered, hash-verified catalogue.
1414
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
1919

2020
## Measured result
2121

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.
2323

2424
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.
2525

@@ -58,18 +58,18 @@ skillleaf --help
5858
After the repository is public, Cargo can install the same source directly:
5959

6060
```sh
61-
cargo install --git https://github.com/derek-codebridge/skillleaf --locked
61+
cargo install --git https://github.com/derek-codebridge/Skill-Leaf --locked
6262
```
6363

64-
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.
6565

6666
## Migrate an existing library safely
6767

6868
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.
6969

7070
### macOS and Linux
7171

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.
7373

7474
```sh
7575
skillleaf_root="$HOME/.local/share/skillleaf"
@@ -96,12 +96,12 @@ SKILLLEAF_CATALOG="$skillleaf_root/catalog.json" skillleaf doctor
9696

9797
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.
9898

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.
100100

101101
### Windows PowerShell
102102

103103
```powershell
104-
$SkillleafRoot = Join-Path $env:LOCALAPPDATA "Skillleaf"
104+
$SkillleafRoot = Join-Path $env:LOCALAPPDATA "Skill-Leaf"
105105
$BackupRoot = Join-Path $SkillleafRoot ("backups\" + (Get-Date -Format "yyyyMMdd-HHmmss"))
106106
New-Item -ItemType Directory -Force "$SkillleafRoot\library", $BackupRoot | Out-Null
107107
Copy-Item -Recurse -Force "$HOME\.claude\skills" "$BackupRoot\claude-skills"
@@ -147,7 +147,7 @@ Rollback is simply restoring the backed-up folders to the host's discovery path
147147

148148
## Expected benefit
149149

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:
151151

152152
- smaller session-start prompts because only the router description is always visible;
153153
- 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
157157
- one catalogue shared across Claude Code, Codex, OpenCode, CI and custom agent runners;
158158
- local usage evidence showing which entries earn maintenance and which never get hydrated.
159159

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.
161161

162162
## Supported layout
163163

@@ -174,7 +174,7 @@ dependencies:
174174
---
175175
```
176176

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.
178178

179179
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.
180180

@@ -187,11 +187,11 @@ Relative Markdown links and explicit `dependencies` form the verified chain. Arb
187187
- Source collisions and missing dependencies are errors.
188188
- Prompts, code and credentials stay on the computer.
189189
- 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.
191191

192192
## Deliberate limits
193193

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.
195195

196196
## Use it with an agent
197197

@@ -212,8 +212,8 @@ Counting happens only after a body passes hash and containment checks. Concurren
212212

213213
## Licence
214214

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.
216216

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).
218218

219219
Contributions are welcome under the [contribution terms](CONTRIBUTOR-LICENCE-AGREEMENT.md). Names and branding remain subject to the [trademark policy](TRADEMARKS.md).

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22

33
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.
44

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.

TRADEMARKS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,6 @@
22

33
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.
44

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.
66

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.

skills/skillleaf/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
name: skillleaf
33
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.
44
---
5-
# Skillleaf router
5+
# Skill-Leaf router
66

7-
Use the local Skillleaf binary before loading capability instructions.
7+
Use the local Skill-Leaf binary before loading capability instructions.
88

99
1. Summarise the current task in one concrete sentence.
1010
2. Run `skillleaf resolve --task "<summary>"`.

0 commit comments

Comments
 (0)