feat: add a first-class SKILL.md wrapper for the standalone CodeGraph CLI#1019
Open
mvanhorn wants to merge 1 commit into
Open
feat: add a first-class SKILL.md wrapper for the standalone CodeGraph CLI#1019mvanhorn wants to merge 1 commit into
mvanhorn wants to merge 1 commit into
Conversation
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Author a single agent-agnostic skill document at
skills/codegraph-cli/SKILL.mdthat describes when to reach for CodeGraph and documents the standalone CLI surface (index,query,callers,callees,context, and the other read commands) with concrete invocation examples and output expectations, framed so any skill-aware agent (Claude Code, hermes, etc.) can load it without MCP. Model the structure on the existing developer skills under.claude/skills/*/SKILL.mdfor front-matter/format consistency, but keep this one user-facing and tool-call-oriented (the "prefer the CLI over reading whole files" guidance the maintainer described). Add a short "Use as an agent skill" subsection toREADME.mdand a cross-link from the CLI reference doc (site/src/content/docs/reference/cli.md) pointing at the new skill file so it is discoverable.Why this matters
Users running agents in containers (e.g. hermes) hit setup friction wiring the CodeGraph MCP server across host/container boundaries. The maintainer (colbymchenry) clarified on 2026-06-20 that CodeGraph already ships a full CLI that works completely independently of the MCP server (
codegraph index,codegraph query,codegraph callers,codegraph callees,codegraph context, etc.), so agents can call it directly with no MCP server, volume-sharing, or network alias. The reporter (doctorcolossus) responded that what he wants is exactly "at least one SKILL.md file specifically for the CLI" — an agent-agnostic, pre-packaged skill that wraps these commands so an agent prefers them instead of the operator hand-wiring each call.See #676.
Testing
skills/codegraph-cli/SKILL.mdand can run each documented command verbatim against an indexed repo.codegraphCLI surface (no invented or renamed commands).reference/cli.mdlink resolve to the new file path; no broken relative links.Fixes #676