https://github.com/aikdna/kdna-skills
Install KDNA skills for any AI agent: Claude Code, Codex, OpenCode, Cursor, and GitHub Copilot. One skill, one format, multiple agents.
https://github.com/aikdna/kdna-skills
agent-skills ai-agent claude-code codex cursor github-copilot installer kdna opencode skills
Last synced: 4 days ago
JSON representation
Install KDNA skills for any AI agent: Claude Code, Codex, OpenCode, Cursor, and GitHub Copilot. One skill, one format, multiple agents.
- Host: GitHub
- URL: https://github.com/aikdna/kdna-skills
- Owner: aikdna
- License: apache-2.0
- Created: 2026-05-17T04:41:00.000Z (16 days ago)
- Default Branch: main
- Last Pushed: 2026-05-24T03:25:36.000Z (9 days ago)
- Last Synced: 2026-05-24T04:34:47.417Z (9 days ago)
- Topics: agent-skills, ai-agent, claude-code, codex, cursor, github-copilot, installer, kdna, opencode, skills
- Language: Shell
- Homepage: https://aikdna.com
- Size: 71.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
README
> [aikdna.com](https://aikdna.com) -- Official website . [](https://www.npmjs.com/package/@aikdna/kdna-cli)
# 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 data 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](https://github.com/aikdna/kdna/blob/main/docs/GOVERNANCE.md).
Requires `@aikdna/kdna-cli` CLI:
```bash
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 `. Stored as immutable `.kdna` files under `~/.kdna/packages/` and indexed by `~/.kdna/index.json`. Loaded on demand per task. |
| **kdna CLI** (tool) | `kdna init`, `kdna install`, `kdna verify`, `kdna publish`. Stable interface for domain management. |
## Supported Agents
`kdna setup` auto-detects and installs `kdna-loader` into:
- **Codex** — `~/.codex/skills/kdna-loader/`
- **Claude Code** — `~/.claude/skills/kdna-loader/`
- **OpenCode** — `~/.agents/skills/kdna-loader/`
- **Cursor** — `~/.cursor/skills/kdna-loader/`
- **GitHub Copilot** — `~/.agents/skills/kdna-loader/`
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/`](./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
```bash
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
```bash
kdna list --available # Browse registry
kdna install code_review # Install a domain
kdna verify @aikdna/code_review --judgment
```
### Create your own domain
```bash
kdna dev init my_expertise
# Fill in the dev source workspace
kdna dev validate my_expertise
kdna publish my_expertise --output dist/my_expertise.kdna
```
Or use the **KDNaStudio** Mac App or **VS Code extension** for guided authoring.
## 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
```bash
# 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
[中文](./README.zh.md)