convez.ai
MCP ServerAutomaçãoAvançado
aikdna

KDNA Skills — Loader Unificado para Agentes IA

aikdna/kdna-skills

Um skill, múltiplos agentes, pacotes KDNA compartilhados

Ver no GitHub
BomPluginScore · de 0 a 100

Sistema 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-skills

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 dias
Versão
kdna-mcp-server-0.8.0
Issues abertas
4
Contribuidores
2

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 . npm

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

WhatWhere
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:

AgentSkill PathGuide
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.inspect
  • kdna.verify
  • kdna.load
  • kdna.match
  • kdna.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)

  1. Decide whether KDNA applies at all (skip for formatting, lookup, code execution)
  2. Discover installed domains via kdna available --json
  3. Evaluate fit per domain (checks applies_when / does_not_apply_when)
  4. Select 0 or 1 domain (never silently blend multiple)
  5. Load via kdna load @scope/name (prompt mode, ~30-50% smaller than raw JSON)
  6. Apply silently -- reason from axioms, never quote KDNA to user
  7. 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

中文

Ver o original no GitHub

Bom para

Relacionados