KDNA Skills — Loader Unificado para Agentes IA
aikdna/kdna-skills
Um skill, múltiplos agentes, pacotes KDNA compartilhados
Ver no GitHubSistema modular que instala um único skill (kdna-loader) em múltiplos agentes IA (Claude Code, Codex, Cursor, GitHub Copilot) e gerencia pacotes de cognição de domínio (.kdna) compartilhados. Funciona como camada de julgamento estruturado, não override de permissões.
Instalação
npx convez-ai aikdna/kdna-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Ensinar agentes IA protocolos estruturados de descoberta e carregamento de domínios
- Gerenciar conhecimento de domínio verificado e assinado entre diferentes agentes
- Validar e aplicar axiomas de julgamento sem sobrescrever políticas de segurança
Veredito

Abordagem sofisticada de orquestração de skills com mecanismo de governança criptográfica. Exige CLI local e compreensão de pipelines de compilação KDNA; é arquitetura, não ferramenta trivial. Recomendado para equipes que precisam de cognição de domínio auditável e portable entre múltiplos agentes.
README
A tradução para o português deste README ainda está na fila.
aikdna.com -- Official website .
KDNA Skills
One loader. Many domains.
This repository does not turn KDNA into a skill. It provides adapter skills that allow AI agents to load KDNA.
The kdna-loader skill teaches AI agents a protocol for discovering, loading, and applying KDNA domain cognition packages. Domains are .kdna assets managed by kdna CLI, not separate skills.
KDNA shapes judgment, not tool permission. KDNA does not override system or safety policy. Unsigned, yanked, or high-risk domains are not silently trusted. See KDNA Governance.
Requires @aikdna/kdna-cli CLI:
npm i -g @aikdna/kdna-cli
kdna setup
How it works
| What | Where |
|---|---|
| kdna-loader (single skill) | Installed into your agent by kdna setup. Teaches the agent the protocol for KDNA discovery and application. |
| KDNA assets (data) | Installed via kdna install <name>. Stored as immutable .kdna files under ~/.kdna/packages/ and indexed by ~/.kdna/index.json. Loaded on demand per task. |
| kdna CLI (tool) | kdna install, kdna verify, kdna load, kdna compare, kdna publish <file.kdna>. Stable runtime control plane for existing assets. |
Supported Agents
kdna setup auto-detects and installs kdna-loader into:
| Agent | Skill Path | Guide |
|---|---|---|
| Codex | ~/.codex/skills/kdna-loader/ | Setup guide → |
| Claude Code | ~/.claude/skills/kdna-loader/ | Setup guide → |
| OpenCode | ~/.agents/skills/kdna-loader/ | Setup guide → |
| Cursor | ~/.cursor/skills/kdna-loader/ | Setup guide → |
| GitHub Copilot | ~/.agents/skills/kdna-loader/ | Manual setup required |
All agents share the same KDNA asset store: ~/.kdna/packages/ plus ~/.kdna/index.json.
MCP Server
This repository also includes a minimal MCP adapter in
mcp-server/. Use it when an agent runtime supports MCP and
should access KDNA through stable tools instead of reading KDNA internals
directly.
Exposed tools:
kdna.inspectkdna.verifykdna.loadkdna.matchkdna.available
Quick Install
npm i -g @aikdna/kdna-cli
kdna setup
kdna install @aikdna/writing
kdna doctor --agents
After Installing
Load domain cognition
The agent automatically decides per task whether KDNA applies. When a domain fits, it loads silently -- applying axioms, using preferred terminology, honoring boundaries, and running self-checks. The user sees better judgment, not KDNA internals.
Install more domains
kdna list --available # Browse registry
kdna install code_review # Install a domain
kdna verify @aikdna/code_review --judgment
Create your own trusted KDNA
Agents and skills do not create trusted KDNA assets. They may help draft judgment proposals or candidate cards, but Human Lock and compile/export must happen in KDNA Studio or a Studio-compatible compiler.
A .kdna asset is not created by writing JSON files. It is compiled by a
Studio-compatible authoring pipeline that performs human confirmation,
validation, canonicalization, identity generation, digest computation, signing,
optional encryption, and provenance recording.
kdna install @aikdna/writing
kdna verify @aikdna/writing --judgment
kdna load @aikdna/writing
Use the KDNA Studio Mac App or Studio-compatible SDK/CLI for Human Lock, compile, and export.
How kdna-loader works (7-part protocol)
- Decide whether KDNA applies at all (skip for formatting, lookup, code execution)
- Discover installed domains via
kdna available --json - Evaluate fit per domain (checks
applies_when/does_not_apply_when) - Select 0 or 1 domain (never silently blend multiple)
- Load via
kdna load @scope/name(prompt mode, ~30-50% smaller than raw JSON) - Apply silently -- reason from axioms, never quote KDNA to user
- Respect boundaries -- user intent > evidence > safety > skills
Manual Installation
# Codex
mkdir -p ~/.codex/skills/kdna-loader
cp kdna-loader/SKILL.md ~/.codex/skills/kdna-loader/SKILL.md
# Claude Code
mkdir -p ~/.claude/skills/kdna-loader
cp kdna-loader/SKILL.md ~/.claude/skills/kdna-loader/SKILL.md
# OpenCode
mkdir -p ~/.agents/skills/kdna-loader
cp kdna-loader/SKILL.md ~/.agents/skills/kdna-loader/SKILL.md
License
Apache-2.0