Skip to main content

Skill and agent recommendation system for Claude Code — knowledge graph, wiki, and intake quality gates

Project description

ctx — Skill & Agent Recommendation for Claude Code

License: MIT Python 3.11+ PyPI Tests Graph Docs

Watches what you develop, walks a knowledge graph of 1,789 skills and 464 agents (2,253 nodes, 454K edges, 93 communities), and recommends the right ones on the fly — you decide what to load and unload. Powered by a Karpathy LLM wiki with persistent memory that gets smarter every session.

Why it exists

  • Discovery — with 1,700+ skills and 400+ agents, you can't possibly know which exist or which apply to your current repo.
  • Context budget — loading everything wastes tokens and degrades quality. You need the right 10–15 per session.
  • Skill rot — skills you installed months ago and never used are cluttering context. Stale ones should be flagged automatically.

Install

pip install claude-ctx
ctx-init --hooks            # one-shot setup: directories, hooks, starter toolboxes

Optional extras: pip install "claude-ctx[embeddings]" for the semantic backend, pip install "claude-ctx[dev]" for the test toolchain.

Pre-built knowledge graph (optional)

A pre-built knowledge graph of 2,253 nodes and 454K edges ships as a tarball. Extract to get a ready-to-use ~/.claude/skill-wiki/:

# after `git clone` — or download graph/wiki-graph.tar.gz from the GitHub release
mkdir -p ~/.claude/skill-wiki
tar xzf graph/wiki-graph.tar.gz -C ~/.claude/skill-wiki/

Use

After install, the ctx hooks integrate automatically with Claude Code's PostToolUse + Stop events. Typical flow:

ctx-scan-repo --repo .     # scan current repo, surface recommended skills/agents
ctx-skill-quality list     # four-signal quality score for every skill
ctx-skill-quality explain python-patterns   # drill into a single skill
ctx-skill-health dashboard # structural health + drift detection
ctx-toolbox run --event pre-commit          # run a council on the current diff
ctx-monitor serve          # local dashboard: http://127.0.0.1:8765/

The ctx-monitor dashboard shows currently loaded skills with load/unload buttons, a cytoscape graph view (/graph?slug=…), the LLM-wiki entity browser (/wiki/<slug>), a filterable skills grid, a session timeline, an audit log viewer, and a live SSE event stream.

Full docs, architecture, and every module: https://stevesolun.github.io/ctx/

License

MIT — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_ctx-0.6.4.tar.gz (236.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_ctx-0.6.4-py3-none-any.whl (270.6 kB view details)

Uploaded Python 3

File details

Details for the file claude_ctx-0.6.4.tar.gz.

File metadata

  • Download URL: claude_ctx-0.6.4.tar.gz
  • Upload date:
  • Size: 236.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for claude_ctx-0.6.4.tar.gz
Algorithm Hash digest
SHA256 c26881065ab27a1fa59e94e0cc24bc910d1a7ef4678eb81ddbe02bc8f6f8b8a6
MD5 2175dce273a5647e0a2baf474d896e52
BLAKE2b-256 49e1fe28d18c4951a85379c79a7ead39467837d85811d60be855c31b321d9485

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_ctx-0.6.4.tar.gz:

Publisher: publish.yml on stevesolun/ctx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file claude_ctx-0.6.4-py3-none-any.whl.

File metadata

  • Download URL: claude_ctx-0.6.4-py3-none-any.whl
  • Upload date:
  • Size: 270.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for claude_ctx-0.6.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5e5dd8ca75afbaf0452a04a0473a664ed0977766777ba30f024b4e844dc846b4
MD5 876667872f4508f71ae368d651597d4e
BLAKE2b-256 a9ce42e55f1f1b259b439839c1a7263a5905fa436036b69aefc4dceb725f4a4e

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_ctx-0.6.4-py3-none-any.whl:

Publisher: publish.yml on stevesolun/ctx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page