Agent skill

Runtime skill graph resolver for progressive disclosure of AI agent skills.

Install

npx -y skills add bryanwhl/skill-graph --skill agent-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use the local skill-graph CLI to resolve tasks into graph-based skill context, load shallow context first, and expand full skills only when needed.

SKILL.md

3.5 KB, as published. Nobody here has run it

skill-graph

Use this skill when a task could benefit from specialized agent skills, especially work involving frontend polish, testing, documentation, deployment, security review, performance, or framework-specific implementation.

Runtime Loop

Resolve the task before specialized work:

skill-graph resolve "<task>" --format markdown

Load the selected shallow context first.
Inspect the task and repository.

Expand only nodes justified by new evidence:

skill-graph expand <node-id> --depth summary

Expand to full context only when the summary is insufficient:
```
skill-graph expand <node-id> --depth full
```
Ask before installing any remote skill.
At the end, report which nodes were loaded and which frontier nodes were skipped.

Commands

skill-graph index: scan local skill roots and write .skill-graph/index.json.
skill-graph index --skills-sh-query "<query>": include not-installed skills.sh candidates in the graph for the current domain.
skill-graph remote-cache "<query>": cache skills.sh candidates and show approval-required install commands.
skill-graph embeddings index: build a local semantic embedding index. Use the default qwen3-local provider only when local Python dependencies and model storage are acceptable; use --provider deterministic for tests and demos.
skill-graph embeddings index --trust-remote-code: allow model repository code execution only after explicit human review of the model source.
skill-graph embeddings info: show the saved local embedding provider, model, dimensions, and vector count.
skill-graph edges suggest: propose inferred edges from embedding similarity for human review; do not treat proposed edges as canonical.
skill-graph search "<query>": search the local graph with BM25 by default; use --strategy lexical for baseline comparison, --strategy semantic after embeddings exist, or --strategy hybrid for BM25 plus lexical plus semantic fusion.
skill-graph resolve "<task>": return selected nodes, context depths, frontier nodes, conflicts, missing nodes, scoring provider provenance, and reasons. Hybrid resolution includes semantic results only when a local embedding index already exists.
skill-graph expand <node-id> --depth <depth>: load deeper context for one node.
skill-graph context: show context layers loaded in the current workspace.
skill-graph explain --last: explain the last resolution path.
skill-graph install <node-id>: show the exact dry-run install command for a remote node when available.

Operating Rules

Prefer installed local skills when they are good enough.
Use ancestors at shallow depth.
Use direct matches at the deepest useful depth allowed by budget.
Keep complements on the frontier until the task requires them.
Treat conflicts as warnings that need human review before loading both skills at full depth.
Treat inferred edge suggestions as review items, not active resolver policy.
Never install remote skills without explicit user approval.
Treat remote-cache results as metadata only until the user approves an install.
Do not enable any embedding provider that uploads local task, repository, or private skill text without explicit human approval.
Do not pass --trust-remote-code unless the user explicitly accepts local execution of model repository code.