@zenku/agent-kit 0.1.5 → 0.1.6

package/README.md

@@ -0,0 +1,138 @@
+# @zenku/agent-kit
+
+Skills, agents, and personas for the Zenku ecosystem. Works with Claude Code, OpenCode, and Codex CLI.
+
+## Contents
+
+### Skills
+
+| Name              | Description                                                                       |
+| ----------------- | --------------------------------------------------------------------------------- |
+| `frontend-design` | Create distinctive, production-grade frontend interfaces with high design quality |
+| `skill-creator`   | Guide for creating effective skills that extend agent capabilities                |
+| `zenku-kanban`    | Manage kanban projects, issues, labels, and comments via the zenku CLI            |
+
+### Agents
+
+| Name                    | Description                                                                           |
+| ----------------------- | ------------------------------------------------------------------------------------- |
+| `code-architect`        | Designs feature architectures by analyzing codebase patterns and conventions          |
+| `code-explorer`         | Deeply analyzes codebase features by tracing execution paths and mapping architecture |
+| `code-reviewer`         | Reviews code for bugs, security vulnerabilities, and quality issues                   |
+| `code-simplifier`       | Simplifies code for clarity and maintainability while preserving functionality        |
+| `silent-failure-hunter` | Identifies silent failures, inadequate error handling, and suppressed errors          |
+| `skill-reviewer`        | Reviews skill quality and ensures skills follow best practices                        |
+
+### Personas
+
+| Name    | Description                                                       |
+| ------- | ----------------------------------------------------------------- |
+| `zenku` | A focused, minimal coding assistant with a Japanese zen aesthetic |
+
+## Installation
+
+Install the package globally:
+
+```bash
+npm install -g @zenku/agent-kit
+```
+
+Then copy the artifacts you want into your project.
+
+### Claude Code
+
+```bash
+KIT=$(npm root -g)/@zenku/agent-kit
+
+# Skills → .claude/skills/
+mkdir -p .claude/skills
+unzip -o "$KIT/skills/frontend-design.skill" -d .claude/skills/frontend-design/
+
+# Agents → .claude/agents/
+mkdir -p .claude/agents
+unzip -o "$KIT/agents/code-reviewer.agent" -d .claude/agents/
+
+# Personas → .claude/agents/ (personas are used as main thread agents)
+unzip -o "$KIT/personas/zenku.persona" -d .claude/agents/
+```
+
+To use a persona as your default agent:
+
+```bash
+# Via CLI flag
+claude --agent zenku
+
+# Or set in .claude/settings.json
+{
+  "agent": "zenku"
+}
+```
+
+### OpenCode
+
+```bash
+KIT=$(npm root -g)/@zenku/agent-kit
+
+# Skills → .opencode/skills/
+mkdir -p .opencode/skills
+unzip -o "$KIT/skills/frontend-design.skill" -d .opencode/skills/frontend-design/
+
+# Agents → .opencode/agents/
+mkdir -p .opencode/agents
+unzip -o "$KIT/agents/code-reviewer.agent" -d .opencode/agents/
+unzip -o "$KIT/personas/zenku.persona" -d .opencode/agents/
+```
+
+### Manual
+
+Each `.skill`, `.agent`, and `.persona` file is a standard zip archive. You can unzip them with any tool:
+
+```bash
+unzip frontend-design.skill -d frontend-design/
+unzip code-reviewer.agent
+unzip zenku.persona
+```
+
+Inside each archive is one or more `.md` files with YAML frontmatter and a markdown body.
+
+## Usage
+
+**Skills** are invoked with slash commands (e.g., `/frontend-design`) or triggered automatically when the agent detects a matching task.
+
+**Agents** are specialized sub-agents spawned for specific tasks. They appear in agent selection when placed in the agents directory.
+
+**Personas** replace the default AI identity for the entire session. Set one as your main thread agent to change the assistant's personality, tone, and behavior.
+
+## Uninstall
+
+Remove the files you copied:
+
+```bash
+# Claude Code
+rm -rf .claude/skills/frontend-design/
+rm -f .claude/agents/code-reviewer.md
+rm -f .claude/agents/zenku.md
+
+# OpenCode
+rm -rf .opencode/skills/frontend-design/
+rm -f .opencode/agents/code-reviewer.md
+rm -f .opencode/agents/zenku.md
+```
+
+## Update
+
+When a new version is published:
+
+```bash
+npm update -g @zenku/agent-kit
+```
+
+Then re-copy the artifacts you use (see Installation above). New versions may add, update, or remove artifacts — check the manifest for changes:
+
+```bash
+cat $(npm root -g)/@zenku/agent-kit/manifest.json
+```
+
+## Manifest
+
+The `manifest.json` file at the package root lists all included artifacts with their frontmatter metadata. Use it to programmatically discover available skills, agents, and personas.

package/manifest.json

@@ -51,5 +51,13 @@
       "color": "cyan",
       "tools": "[\"Read\", \"Grep\", \"Glob\"]"
     }
+  },
+  "personas": {
+    "zenku": {
+      "name": "zenku",
+      "description": "A focused, minimal coding assistant with a Japanese zen aesthetic",
+      "model": "inherit",
+      "color": "cyan"
+    }
   }
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@zenku/agent-kit",
-  "version": "0.1.5",
-  "description": "Agent kit (skills, agents, commands) for the Zenku ecosystem — works with Claude Code, OpenCode, and Codex CLI.",
+  "version": "0.1.6",
+  "description": "Agent kit (skills, agents, personas) for the Zenku ecosystem — works with Claude Code, OpenCode, and Codex CLI.",
   "files": [
     "skills",
     "agents",
+    "personas",
     "manifest.json"
   ],
   "license": "SEE LICENSE IN LICENSE"