Success
What a successful outcome looks like for this skill.
Success:
Turn AI instructions into Standard Operating Procedures your AI can actually execute. Author once — Graphnosis personalises against your memory, links steps as a typed graph, and hands any MCP-connected AI a deterministic plan to run.
The shift
Most AI tools store instructions as flat blobs — a system prompt, a CLAUDE.md,
a .cursorrules file. Graphnosis compiles them into
Standard Operating Procedures — steps in order, loops and
branches detected, sub-skill calls wired, named inputs and outputs declared.
The AI doesn’t read prose — it walks a typed graph.
Everywhere else
In Graphnosis
Requires / Produces variables, plus failure handlers@skill name(args) -> $captureThe result: an AI doesn’t guess what your skill meant — it reads the structure and walks it. Recall’d memories arrive at the right step. Failures route to the recovery skill you declared. The handoff is deterministic.
Goals — built in, not bolted on
Every skill carries a goals block. The AI reads it before invoking the skill, during execution, and after — so it knows when to fire, what it needs, what it should produce, and where to route failure.
What a successful outcome looks like for this skill.
Success:
What this skill should not attempt — bounds the AI’s authority.
Out of scope:
What tangible output or behaviour is expected when the skill completes.
On completion:
When the AI should autonomously invoke this skill — the gate for self-routing.
Trigger:
What must be true before step 1 can run. Checked before any work happens.
Prerequisites:
Recovery if execution fails mid-procedure. May name a recovery skill to invoke.
On failure:
Named inputs this skill expects from its caller or context. $camelCase.
Requires:
Named outputs this skill makes available to callers. Captured by the next step.
Produces:
AI clients receive a structured SkillExecutionPlan
JSON containing every goal value. They confirm prerequisites before they start,
capture Produces outputs into named
variables, and route exceptions through declared failure handlers.
Composition
One orchestrator skill, several sub-skills, named arguments, captured return values, a recovery skill on failure. Every link is a graph edge the AI can walk — not text it has to parse.
[ANCHOR] Deploy the named branch to production safely.
Each step gates the next; on any failure, hand off to
the rollback skill.
@skill: validate-environment(branch=$branch) -> $envOk
If $envOk is false, abort and surface the
validation report.
@skill: run-migrations(branch=$branch) -> $migrationReport
@skill: smoke-tests(branch=$branch) -> $smokeReport
If $smokeReport.failed > 0, the deploy is not
complete — invoke the rollback path. Goals
Success: the branch is live, migrations are applied, smoke tests are green
Out of scope: modifying production data, bypassing CI, deploying without a code review
Prerequisites: CI on the branch is green, $branch variable is set
On failure: invoke @skill: rollback-deployment with the failure context
Requires: $branch ·
Produces: $envOk, $migrationReport, $smokeReport
What an AI does with this
walk_skill_structured on Safe Deploy.requires: ['$branch'] and confirms $branch=main with the user.prerequisites and asks the user to confirm CI is green.validate-environment, captures $envOk.$envOk is false, surfaces it and stops.failureHandlers[0].targetTitle = rollback-deployment.
Sub-skill calls work in English, Romanian, Spanish, French, German, Italian, and Portuguese
out of the box, plus a language-neutral explicit syntax (@loop: N,
@branch: N) that detection always tries first.
Tools your AI uses
Every trained skill is reachable from any MCP-connected AI client through one of two tools. The narrative tool is for explaining; the structured tool is for executing.
walk_skill Returns the skill as human-readable text with CONSTRAINTS and PROCEDURE sections. Loop-back steps, conditional branches, and sub-skill invocations are annotated inline.
Use when explaining the skill to a user, or guiding them through it conversationally one step at a time.
Step 1: Configure the environment...
→ Context: prior CI fixture for this branch
Step 2: Run the validation suite...
Step 3: INVOKES SKILL: run-migrations
Step 4: Review logs — BRANCHES to step 6 if failed
Step 5: LOOPS BACK to step 2 walk_skill_structured
Returns a SkillExecutionPlan with
requires, produces,
ordered steps with calls (target sub-skill + args +
captureAs), plus failureHandlers.
Use when the AI is actually going to execute the skill — walk steps in order, invoke sub-skills with named args, capture return values, route exceptions through declared failure handlers.
{
"skill": { "title": "Safe Deploy", ... },
"requires": ["$branch"],
"produces": ["$envOk", "$migrationReport"],
"constraints": {
"prerequisites": "CI on the branch is green",
"onFailure": "rollback-deployment"
},
"steps": [
{ "index": 1, "text": "...",
"calls": {
"targetTitle": "validate-environment",
"args": ["$branch"],
"captureAs": "$envOk"
}
}, ...
]
} Retraining
Retrain a skill against fresh memory — goals, recipes, and structure are rewritten in place. The prior version is saved to an encrypted side-table so you can roll back any retrain that drifted.
The skill’s graph nodes are mutated in place. Cross-source edges referencing this skill stay intact. No orphan title nodes accumulate in your engram from old trains.
Before every retrain, the prior state is dumped to
.json.enc under
skill-snapshots/, sealed with the same
data key that protects your .gai engrams.
rollback_skill restores any
prior version. The current state is re-snapshotted first — so even
the rollback itself is reversible.
The trainer also self-tunes recall breadth — on each train, the cited-vs-fetched ratio nudges the next retrain’s recall window wider or tighter. You don’t tune it — it learns.
See your SOPs
A force-directed 3D view of your cortex — nodes drift instead of snapping, edges colour by category, GNN predictions float in as a dashed overlay you can toggle. Watch your skills settle into clusters; drag a node and pin it.
3D Engram screenshot — drop at /3d-engram-skills.png
Reasoning · Structure · Social · Temporal · Semantic · Identity · Predicted — the legend toggles each independently.
Graphnosis is modelled on the hippocampus — the brain region that binds disparate memories into something coherent. This view is its digital twin. Drag any node to study its neighbourhood; the physics engine pins it where you dropped it. Watch dense clusters loosen, isolated nodes drift to the rim, and the shape of your AI’s memory emerge. The first time you flatten a tangled SOP chain by hand and see why two skills were quietly related, you’ll know what your AI has actually been seeing.
A local graph neural network proposes edges your explicit notes never made — rendered as a dashed lime layer that you toggle on or off. The deterministic graph below stays untouched; the network just shows you what it thinks is missing.
Each node carries its source colour — the .gsk pack it came from, the document it was ingested from, the skill it’s part of. Cross-source clusters jump out instantly.
Hover a legend category to fade everything else. Click to lock the filter. Hide an entire source while you work on another. The atlas is your workshop, not a museum.
Click any node — the inspector opens with its content, type, confidence, source provenance, and every incoming/outgoing edge with evidence labels. The atlas IS the inspector.
Built on a force-directed simulator with cursor-aware zoom and a left-aligned camera that compensates for the legend strip — so your fit-view always frames the cortex, not the chrome.
Portable, verifiable, free
A .gsk file is the wire format
for Graphnosis skills — AES-256-GCM encrypted JSON wrapping the skill
text, recall recipes, structured goals, and an optional
GRAPHNOSIS.md companion. Ed25519 signature
is the real integrity gate: tampered files hard-fail import.
Role-matched .gsk kits for engineering, healthcare, legal,
finance, defense, robotics, education — every kit free.
Every official pack carries a signature. The import UI shows a ✓ Verified badge or ⚠ Community on unsigned packs. Tampered files reject before any byte reaches your cortex.
On first cortex unlock, the App auto-creates a Skill Demos engram and imports three signed teaching skills: Use Graphnosis well, Save memories that last, and Stay safe with sensitive memories.
claude-md ·
cursorrules ·
system-prompt ·
openai ·
raw ·
gsk — export to the
format your tool expects.
Privacy by design
Export serialises only the structural payload — skill text, recipes,
graphnosisMd, goals.
It never sees your personal memory engrams.
The direction of personalisation travels; the memories that caused it stay local.
Skill vitality
Every trained skill carries a vitality score — 0 to 100, measured by how many of the memories that originally shaped it have since been forgotten, edited, or superseded.
train_skill.
The score is exposed through the skill_vitality
MCP tool so AI clients can prompt the user to retrain stale skills before
acting on them.
Example library
From file to walked SOP
A CLAUDE.md, a system prompt, a .cursorrules
file — or download one of 100+ free .gsk
packs from the Job Memory Kits library.
Declare any of the eight goal categories. The trainer runs goal-aligned recall — per-category queries that surface the memories most relevant to each dimension of your skill.
The trainer interleaves your memories at the exact step where they
fit. With Ollama on, you watch the rewrite stream in live with
(from memory: ...) attribution
on every changed line.
Export to your tool’s format, or leave the skill in Graphnosis
and let any MCP-connected AI walk it via
walk_skill_structured.
Anchored lines
Any line you prefix with [ANCHOR]
is preserved exactly across every retrain — no paraphrase, no rewrite.
Use anchors for the parts of your SOP that must never drift.
Every skill is signed, structured, and executable. Every retrain stays one source. Every exception routes to the recovery skill you declared. Every byte that shaped the personalisation stays on your machine.
That’s the praxis: AI that knows what to do, why it’s doing it, and what to do when it goes wrong — because you told it once, in a form it can execute.
Download Graphnosis, unlock your cortex, and open the Skills tab. The free tier gives you author / browse / walk / retrain against your memory with a Personal Context block. Pro adds the streaming LLM rewrite with per-line memory attribution.
Free forever · 100+ signed .gsk packs · macOS 13+ · Windows 10+