{"id":50324927,"url":"https://github.com/aikdna/kdna-skills","last_synced_at":"2026-05-29T05:04:26.943Z","repository":{"id":358386102,"uuid":"1241200877","full_name":"aikdna/kdna-skills","owner":"aikdna","description":"Install KDNA skills for any AI agent: Claude Code, Codex, OpenCode, Cursor, and GitHub Copilot. One skill, one format, multiple agents.","archived":false,"fork":false,"pushed_at":"2026-05-24T03:25:36.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T04:34:47.417Z","etag":null,"topics":["agent-skills","ai-agent","claude-code","codex","cursor","github-copilot","installer","kdna","opencode","skills"],"latest_commit_sha":null,"homepage":"https://aikdna.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aikdna.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-17T04:41:00.000Z","updated_at":"2026-05-24T03:25:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aikdna/kdna-skills","commit_stats":null,"previous_names":["knowledge-dna/kdna-skills","aikdna/kdna-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aikdna/kdna-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aikdna%2Fkdna-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aikdna%2Fkdna-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aikdna%2Fkdna-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aikdna%2Fkdna-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aikdna","download_url":"https://codeload.github.com/aikdna/kdna-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aikdna%2Fkdna-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33637486,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agent","claude-code","codex","cursor","github-copilot","installer","kdna","opencode","skills"],"created_at":"2026-05-29T05:04:05.644Z","updated_at":"2026-05-29T05:04:26.937Z","avatar_url":"https://github.com/aikdna.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [aikdna.com](https://aikdna.com) -- Official website . [![npm](https://img.shields.io/npm/v/@aikdna/kdna-cli)](https://www.npmjs.com/package/@aikdna/kdna-cli)\n\n# KDNA Skills\n\n**One loader. Many domains.**\n\nThis repository does not turn KDNA into a skill. It provides adapter skills that allow AI agents to load KDNA.\n\nThe `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.\n\n**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).\n\nRequires `@aikdna/kdna-cli` CLI:\n\n```bash\nnpm i -g @aikdna/kdna-cli\nkdna setup\n```\n\n## How it works\n\n| What | Where |\n|---|---|\n| **kdna-loader** (single skill) | Installed into your agent by `kdna setup`. Teaches the agent the protocol for KDNA discovery and application. |\n| **KDNA assets** (data) | Installed via `kdna install \u003cname\u003e`. Stored as immutable `.kdna` files under `~/.kdna/packages/` and indexed by `~/.kdna/index.json`. Loaded on demand per task. |\n| **kdna CLI** (tool) | `kdna init`, `kdna install`, `kdna verify`, `kdna publish`. Stable interface for domain management. |\n\n## Supported Agents\n\n`kdna setup` auto-detects and installs `kdna-loader` into:\n\n- **Codex** — `~/.codex/skills/kdna-loader/`\n- **Claude Code** — `~/.claude/skills/kdna-loader/`\n- **OpenCode** — `~/.agents/skills/kdna-loader/`\n- **Cursor** — `~/.cursor/skills/kdna-loader/`\n- **GitHub Copilot** — `~/.agents/skills/kdna-loader/`\n\nAll agents share the same KDNA asset store: `~/.kdna/packages/` plus `~/.kdna/index.json`.\n\n## MCP Server\n\nThis repository also includes a minimal MCP adapter in\n[`mcp-server/`](./mcp-server). Use it when an agent runtime supports MCP and\nshould access KDNA through stable tools instead of reading KDNA internals\ndirectly.\n\nExposed tools:\n\n- `kdna.inspect`\n- `kdna.verify`\n- `kdna.load`\n- `kdna.match`\n- `kdna.available`\n\n## Quick Install\n\n```bash\nnpm i -g @aikdna/kdna-cli\nkdna setup\nkdna install @aikdna/writing\nkdna doctor --agents\n```\n\n## After Installing\n\n### Load domain cognition\n\nThe 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.\n\n### Install more domains\n\n```bash\nkdna list --available    # Browse registry\nkdna install code_review # Install a domain\nkdna verify @aikdna/code_review --judgment\n```\n\n### Create your own domain\n\n```bash\nkdna dev init my_expertise\n# Fill in the dev source workspace\nkdna dev validate my_expertise\nkdna publish my_expertise --output dist/my_expertise.kdna\n```\n\nOr use the **KDNaStudio** Mac App or **VS Code extension** for guided authoring.\n\n## How kdna-loader works (7-part protocol)\n\n1. **Decide** whether KDNA applies at all (skip for formatting, lookup, code execution)\n2. **Discover** installed domains via `kdna available --json`\n3. **Evaluate** fit per domain (checks `applies_when` / `does_not_apply_when`)\n4. **Select** 0 or 1 domain (never silently blend multiple)\n5. **Load** via `kdna load @scope/name` (prompt mode, ~30-50% smaller than raw JSON)\n6. **Apply** silently -- reason from axioms, never quote KDNA to user\n7. **Respect** boundaries -- user intent \u003e evidence \u003e safety \u003e skills\n\n## Manual Installation\n\n```bash\n# Codex\nmkdir -p ~/.codex/skills/kdna-loader\ncp kdna-loader/SKILL.md ~/.codex/skills/kdna-loader/SKILL.md\n\n# Claude Code\nmkdir -p ~/.claude/skills/kdna-loader\ncp kdna-loader/SKILL.md ~/.claude/skills/kdna-loader/SKILL.md\n\n# OpenCode\nmkdir -p ~/.agents/skills/kdna-loader\ncp kdna-loader/SKILL.md ~/.agents/skills/kdna-loader/SKILL.md\n```\n\n## License\n\nApache-2.0\n\n[中文](./README.zh.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faikdna%2Fkdna-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faikdna%2Fkdna-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faikdna%2Fkdna-skills/lists"}