Stevesolun commited on
Commit
f588caa
Β·
verified Β·
1 Parent(s): 738c2a1

Sync ctx 9ecbf5e

Browse files

GitHub commit: 9ecbf5e8bf558dc7a235251c1b12936f0857017b

Files changed (3) hide show
  1. README.md +4 -4
  2. docs/index.md +3 -4
  3. docs/skill-router/index.md +1 -2
README.md CHANGED
@@ -18,8 +18,8 @@ tags:
18
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
19
  [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-green.svg)](https://python.org)
20
  [![PyPI](https://img.shields.io/pypi/v/claude-ctx.svg)](https://pypi.org/project/claude-ctx/)
21
- [![Tests](https://img.shields.io/badge/Tests-4286_collected-brightgreen.svg)](https://github.com/stevesolun/ctx/actions/workflows/test.yml)
22
- [![Graph](https://img.shields.io/badge/Graph-79%2C958_nodes_/_1.8M_edges-red.svg)](https://stevesolun.github.io/ctx/knowledge-graph/)
23
  [![Skills](https://img.shields.io/badge/Skills-68%2C494-blue.svg)](https://stevesolun.github.io/ctx/catalog/?type=skill)
24
  [![Agents](https://img.shields.io/badge/Agents-467-purple.svg)](https://stevesolun.github.io/ctx/catalog/?type=agent)
25
  [![MCPs](https://img.shields.io/badge/MCPs-10%2C790-pink.svg)](https://stevesolun.github.io/ctx/catalog/?type=mcp-server)
@@ -37,13 +37,13 @@ Current shipped snapshot:
37
 
38
  - **68,494 skill entity pages**, with **67,024** hydrated installable `SKILL.md` bodies.
39
  - **467 agents**, **10,790 MCP servers**, and **207 harnesses**.
40
- - **2.6M graph edges** across semantic similarity, tags, slug tokens, source overlap, direct links, quality, usage, type affinity, and graph structure.
41
  - **28,612 long skill bodies** converted through the micro-skill gate instead of shipping raw long prompts.
42
  - Entity updates for skills, agents, MCPs, and harnesses print benefits/risks and skip replacement unless you explicitly approve the update.
43
 
44
  ## Why it exists
45
 
46
- - **Discovery** β€” with 91K+ skill pages, 460+ agents, 10K+ MCP servers, and 207 harnesses, you can't possibly know which exist or which apply to your current work.
47
  - **Context budget** β€” loading everything wastes tokens and degrades quality. You need the right 10–15 per session.
48
  - **Skill rot** β€” skills you installed months ago and never used are cluttering context. Stale ones should be flagged automatically.
49
 
 
18
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
19
  [![Python 3.11+](https://img.shields.io/badge/Python-3.11+-green.svg)](https://python.org)
20
  [![PyPI](https://img.shields.io/pypi/v/claude-ctx.svg)](https://pypi.org/project/claude-ctx/)
21
+ [![Tests](https://img.shields.io/badge/Tests-4287_collected-brightgreen.svg)](https://github.com/stevesolun/ctx/actions/workflows/test.yml)
22
+ [![Graph](https://img.shields.io/badge/Graph-79%2C958_nodes_/_1%2C778%2C069_edges-red.svg)](https://stevesolun.github.io/ctx/knowledge-graph/)
23
  [![Skills](https://img.shields.io/badge/Skills-68%2C494-blue.svg)](https://stevesolun.github.io/ctx/catalog/?type=skill)
24
  [![Agents](https://img.shields.io/badge/Agents-467-purple.svg)](https://stevesolun.github.io/ctx/catalog/?type=agent)
25
  [![MCPs](https://img.shields.io/badge/MCPs-10%2C790-pink.svg)](https://stevesolun.github.io/ctx/catalog/?type=mcp-server)
 
37
 
38
  - **68,494 skill entity pages**, with **67,024** hydrated installable `SKILL.md` bodies.
39
  - **467 agents**, **10,790 MCP servers**, and **207 harnesses**.
40
+ - **1,778,069 graph edges** across semantic similarity, tags, slug tokens, source overlap, direct links, quality, usage, type affinity, and graph structure.
41
  - **28,612 long skill bodies** converted through the micro-skill gate instead of shipping raw long prompts.
42
  - Entity updates for skills, agents, MCPs, and harnesses print benefits/risks and skip replacement unless you explicitly approve the update.
43
 
44
  ## Why it exists
45
 
46
+ - **Discovery** β€” with 68,494 skill pages, 467 agents, 10,790 MCP servers, and 207 harnesses, you can't possibly know which exist or which apply to your current work.
47
  - **Context budget** β€” loading everything wastes tokens and degrades quality. You need the right 10–15 per session.
48
  - **Skill rot** β€” skills you installed months ago and never used are cluttering context. Stale ones should be flagged automatically.
49
 
docs/index.md CHANGED
@@ -55,8 +55,7 @@ memory that gets smarter every session.
55
  Claude Code skills, agents, MCP servers, and model harness profiles are
56
  powerful, but at scale they become unmanageable:
57
 
58
- - **Discovery problem** β€” with 91K+ skill pages, 460+ agents, 10,000+
59
- MCP servers, and 207 harnesses, how do you know which
60
  ones exist and which are relevant to your current project?
61
  - **Context budget** β€” loading every installable entity wastes tokens and
62
  degrades quality. You need exactly the right skills, agents, and MCP
@@ -202,13 +201,13 @@ ones are flagged. New ones self-ingest.
202
  ---
203
 
204
  **v1.0.19** β€” MIT, CI-matrixed (Ubuntu 3.12 plus Windows/macOS 3.11/3.12),
205
- 4,286 tests collected. Ships console scripts including `ctx-init`,
206
  `ctx-monitor` (local dashboard with graph + wiki + load/unload for
207
  skills, agents, and MCP servers, plus Harness Setup for user-owned LLMs),
208
  `ctx-incremental-attach`, `ctx-incremental-shadow`, `ctx-dedup-check`
209
  (pre-ship near-duplicate gate), and
210
  `ctx-tag-backfill` (entity hygiene), plus a fast runtime graph artifact
211
- and the full ~439 MiB wiki tarball with **79,958 nodes / 1,778,069 edges / 52 Louvain communities**.
212
 
213
  [:octicons-arrow-right-24: CHANGELOG](https://github.com/stevesolun/ctx/blob/main/CHANGELOG.md) Β·
214
  [Repository](https://github.com/stevesolun/ctx)
 
55
  Claude Code skills, agents, MCP servers, and model harness profiles are
56
  powerful, but at scale they become unmanageable:
57
 
58
+ - **Discovery problem** β€” with 68,494 skill pages, 467 agents, 10,790 MCP servers, and 207 harnesses, how do you know which
 
59
  ones exist and which are relevant to your current project?
60
  - **Context budget** β€” loading every installable entity wastes tokens and
61
  degrades quality. You need exactly the right skills, agents, and MCP
 
201
  ---
202
 
203
  **v1.0.19** β€” MIT, CI-matrixed (Ubuntu 3.12 plus Windows/macOS 3.11/3.12),
204
+ 4,287 tests collected. Ships console scripts including `ctx-init`,
205
  `ctx-monitor` (local dashboard with graph + wiki + load/unload for
206
  skills, agents, and MCP servers, plus Harness Setup for user-owned LLMs),
207
  `ctx-incremental-attach`, `ctx-incremental-shadow`, `ctx-dedup-check`
208
  (pre-ship near-duplicate gate), and
209
  `ctx-tag-backfill` (entity hygiene), plus a fast runtime graph artifact
210
+ and the full ~314 MiB wiki tarball with **79,958 nodes / 1,778,069 edges / 52 Louvain communities**.
211
 
212
  [:octicons-arrow-right-24: CHANGELOG](https://github.com/stevesolun/ctx/blob/main/CHANGELOG.md) Β·
213
  [Repository](https://github.com/stevesolun/ctx)
docs/skill-router/index.md CHANGED
@@ -8,8 +8,7 @@ skills/agents/MCP recommendation layer can be used by that host.
8
  ## Problem
9
 
10
  Every loaded skill, agent, and MCP server costs tokens, attention, and tool
11
- surface area. Most sessions need a small top-scored bundle from the 91K+ skills,
12
- 460+ agents, and 10K+ MCP servers in the shipped graph, not the whole inventory.
13
  Loading too much:
14
 
15
  - wastes context on irrelevant instructions,
 
8
  ## Problem
9
 
10
  Every loaded skill, agent, and MCP server costs tokens, attention, and tool
11
+ surface area. Most sessions need a small top-scored bundle from the 68,494 skills, 467 agents, and 10,790 MCP servers in the shipped graph, not the whole inventory.
 
12
  Loading too much:
13
 
14
  - wastes context on irrelevant instructions,