okf-memory/okf-agent-memory/skill

Claude Code and agent skill by okf-memory/okf-agent-memory

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Maintain persistent, domain-neutral project memory for AI agents using Open Knowledge Format (OKF) v0.2 bundles and the deterministic okf Go toolchain. Use whenever project knowledge, decisions, runbooks, research, client notes, or domain discoveries must survive conversational resets.

Install

npx vskill@latest install okf-memory/okf-agent-memory/skill

SKILL.md

OKF Agent Memory Skill (AAG Spec v0.1)

Teaches AI agents deterministic interaction with an Open Knowledge Format (OKF v0.2) bundle (knowledge/).

0. Project & Domain Codex

  • GOAL: maintain(high_factual_integrity, domain_neutrality, strict_determinism)
  • FORMAT: diagrams => ASSERT(syntax == mermaid, ELSE=STOP("Mermaid required; ASCII/box art prohibited."))

1. Behavioral Invariants (RFC 2119)

  • MUST execute okf_search(query=keywords, limit=3) before proposing architecture changes or creating concepts.
  • NEVER scan knowledge/ via list_dir, grep_search, or raw file readers.
  • NEVER forge human verification (verified: is human-only; declare generated: { by: "<actor>", at: "<iso-time>" }).
  • PREFER native okf_* MCP tools OVER CLI fallback commands.
  • PREFER okf_update OVER okf_create when mutating existing domain entities.
  • NEVER persist scratchpads, raw chain-of-thought, or speculative chatter to knowledge corpus.

2. Guard Clauses & Scope Governance

  • ON edit(@path/):

IF first_visit(@path/) => okf_search(for_path=@path/) IF governance == "hold" => STOP("Subsystem frozen by governance. Confirm with user.") IF governance == "constraint" => MUST adhere to all listed invariants IF governance == "context" => proceed with awareness

  • ON user_query(architecture | requirements | conventions | domain_facts):

okf_search(query=keywords, limit=3) => evaluate summary description IF relevant => okf_show(concept_id) ONLY on demand

3. Completion Pipeline (Sequential Assertion Gates)

  1. IF arch_decisions_made => MUST okf_create(architecture/*, type="decision", title=..., desc=...)
  2. IF requirements_discovered => MUST okf_update(concept_id)
  3. IF concepts_mutated => MUST sync(knowledge/log.md, knowledge/index.md)
  4. ASSERT(okf_validate(strict=true, drift=true) == {errors: 0, warnings: 0}, ELSE=fix_before_exit)

4. Tooling Reference (Dual-Mode: MCP & CLI)

Default bundle: ./knowledge. For custom paths, pass bundle="path/to/bundle".

TaskPreferred: Native MCP ToolFallback: Deterministic CLI (--json)
Search Knowledgeokf_search(query="<query>", limit=3)okf search "<query>" knowledge --limit 3 --json
Discover Code Constraintsokf_search(for_path="<file-path>")okf search --for-path <file-path> knowledge --json
Inspect Conceptokf_show(concept_id="<id>")okf show <id> knowledge --json
Create Conceptokf_create(concept_id="<id>", type="<type>", title="<title>", description="<desc>")okf create <id> knowledge --type <type> --title "<title>" --desc "<desc>" --json
Update Conceptokf_update(concept_id="<id>", description="<desc>", title="<title>")okf update <id> knowledge --desc "<desc>" --json
Relate Conceptsokf_relate(source_id="<src>", target_id="<tgt>", description="<prose>")okf relate <src> <tgt> knowledge --desc "<prose>" --json
Validate Bundleokf_validate(strict=true)okf validate knowledge --strict --drift --json

5. Workflow Guides (Progressive Disclosure)

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
765
Repository forks
59
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/okf-memory/okf-agent-memory/skill/badge)](https://verified-skill.com/skills/okf-memory/okf-agent-memory/skill)

Something wrong with this skill or its page? Tell us.