Guides
Practical walkthroughs for working with skillgraph. First up: authoring and publishing a skill. (skillgraph is the distribution layer — it versions, publishes, and installs skills; it does not author them. The two layers compose.)
1. Author the skill
A skill is a SKILL.md folder following the open
Agent Skills standard — a name and
description in frontmatter, then your instructions. To write a good one, use
Anthropic's
skill best-practices guide
or the skill-creator plugin. skillgraph
takes it from there.
2. Bring it under management (offline)
skg init ./my-skill writes a skillgraph.node.json sidecar — the
skill's @local coordinate, version, and dependency edges — and records it in
skillgraph.json. No account needed: authoring is fully offline. A bare
SKILL.md folder stays private and untouched until you opt it in this way.
3. Compose offline
Wire skills together with skg dep add my-skill other-skill (a local edge is stored
as @local/other-skill; depend on someone else's by full @scope/name).
Then skg install reconciles the project from local content — resolving
@local skills straight from .claude/skills/, no network — and writes the
lock. Drop a skill with skg remove (it keeps your SKILL.md by default).
4. Sign in (only to publish)
skg login opens GitHub in your browser; the first time, you claim your
@scope — your publishing namespace. You never type it again: the registry stamps
it onto everything you publish, so you can only ever publish under your own.
5. Publish
skg publish ./my-skill validates the dependency graph (acyclic, no dangling
references), stamps your @scope — rewriting @local edges to
@you — and publishes leaves-first. Published versions are immutable — bump the
version to change a skill. Point publish at a directory to publish every managed
skill under it.
Fork instead of starting from scratch
skg fork @other/name is an authenticated server operation: the registry mints
@you/name from the origin and records the provenance itself, so lineage can't be
forged. Then skg install @you/name to pull it down and edit.
Driving skillgraph from an agent
Most skillgraph use now happens through an agent. Install the skg-skill meta-skill
and your agent learns to search, install, publish, and fork on its own —
skg install @raghuveer/skg-skill.