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.2.tar.gz (232.3 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.2-py3-none-any.whl (266.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_ctx-0.6.2.tar.gz
  • Upload date:
  • Size: 232.3 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.2.tar.gz
Algorithm Hash digest
SHA256 760f9c653dc095e24912e35126ccc97dd73b43c1841e875bf67458f771d740fa
MD5 539542b01449084e22db6f88907b79d7
BLAKE2b-256 6dbf2f5a524bfa308bf8f7b6a57cc87cf5369cf055336f79dc9158c7ad55e4fb

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: claude_ctx-0.6.2-py3-none-any.whl
  • Upload date:
  • Size: 266.9 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8bc42f30567fe4423e13de1c8399b043e896cede7ed5ddc0adf16978866534e8
MD5 9798bc2a09f7e5eb27298d2ffeeaa5e5
BLAKE2b-256 4faf0fef950c0b24b8da013d21b1d586b184339aa66a8c031625d48087a871a2

See more details on using hashes here.

Provenance

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