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 446 agents (2,235 nodes, 448K edges, 95 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,211 nodes and 642K 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.0.tar.gz (232.1 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.0-py3-none-any.whl (266.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_ctx-0.6.0.tar.gz
  • Upload date:
  • Size: 232.1 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.0.tar.gz
Algorithm Hash digest
SHA256 61b69997cf3de461f866d968aeded6fb31eadde296d9cf6e83add0478e920c0f
MD5 e7e269ca585d966fe8781c3cfb3a73bf
BLAKE2b-256 a0e481af7d3fe5d241336010991bff13864c0884881b4710f73fb8e7a74237b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_ctx-0.6.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: claude_ctx-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 266.7 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7f27bd3a4f282a3ba5f089e4c2f6498e43ff367297db03590fe9f4753629f077
MD5 d3e54c0b0920445192f5a62a30aef962
BLAKE2b-256 40d9269f8d2f19f54eb4d5d7d87ac6663d2b59bd1e6ca392947b477f2a2f273a

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_ctx-0.6.0-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