@graview/skills

Skills that teach an assistant the authoring moves, each ending in a real graview check verdict.

pnpm add @graview/skills

Entry points: @graview/skills, @graview/skills/cli

What it is

Skills that teach an assistant how to build with Graview — and, more usefully, how to find out whether it worked.

npx graview skills install .    # into .claude/skills and .agents/skills
npx graview skills list

The command line is the graview package; this one ships the skills and the move, and graview skills dispatches here.

Why this framework is worth having skills for

Most skills end in a claim: "you have added a node kind." That is worth very little, because the assistant writing it is the same one that just decided it was done.

Graview can answer the question itself. graview check reads the declaration and reports an edge to a kind nobody wrote, an invariant scoped to a kind that does not exist, a repair naming a mutation nobody registered, a lens role bound to a missing field, a mutation with no title, a palette pair that fails WCAG AA, a role that may do nothing. So every skill here ends in a check and reports the real verdict — including when the verdict is bad.

A skill that cannot verify its own outcome says so. That is the rule, and the skills say which parts of their work the checker cannot see.

The skills

SkillThe move it teaches
graview-node-kindAdd a node kind: fields, edges, plural, roles, and what renders for free
graview-invariantWrite a rule that names the mutations that would repair it
graview-lensBuild a lens that binds roles rather than field names, so another domain can reuse it
graview-agent-seatWire an agent seat that shares the interface's actions rather than shadowing them
graview-permissionsDeclare who may do what, once, and let the strip and the seat narrow themselves
graview-brandPut someone's name on an installation without forking a package
graview-new-appStart a product on Graview in its own repository, with the CI that keeps it honest
graview-pagesThe routed face: derived pages, one page in the app's words, a product design over every surface, and the embed
graview-port-appPort an existing application onto Graview, deciding what is a node and what is a field
graview-studioOpen the declaration as a graph, change it with acts, check before applying, migrate, and write it back as the scaffold's files

The worked examples live in apps/ in the framework repository. The skills point at them rather than restating them — a skill that copies an example goes stale the moment the example changes.

What it exports (3)

Read off the package's own barrel, so this is what is there today.

  • readSkills
  • SKILL_DESTINATIONS
  • SKILLS_DIR