Shokunin

v1.0.0Coding Agentsstable

職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cursor, Windsurf. ChromaDB memory, MCP servers, declarative self-updates. Multi-model, open source, zero cost.

ai-agent-skillsai-engineeringai-memorychromadbclaude-code
Share:
85
Stars
0
Downloads
0
Weekly
0/5

What is Shokunin?

Shokunin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 職人 shokunin 62 ai agent skills for opencode, claude code, cursor, windsurf. chromadb memory, mcp servers, declarative self-updates. multi-model, open source, zero cost.

職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cursor, Windsurf. ChromaDB memory, MCP servers, declarative self-updates. Multi-model, open source, zero cost.

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cu

Use Cases

Access 62 AI agent skills for coding and automation.
Use ChromaDB for persistent agent memory across sessions.
Enable multi-model agent workflows with zero cost.
EliasOulkadi

Maintainer

LicenseMIT
Languagehtml
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx shokunin

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Shokunin

Shokunin (職人, meaning artisan in Japanese) is an engineering skill suite that installs 62 curated skill files for AI coding agents such as OpenCode, Claude Code, Cursor, and Windsurf. Each skill file is a structured domain guide covering Docker, Kubernetes, authentication, frontend design, testing, and more, providing agents with deep procedural knowledge and checklists rather than generic prompts. The suite also includes a ChromaDB-backed persistent memory system with 9 MCP tools, enabling agents to recall context across sessions using vector, BM25, and temporal ranking.

Prerequisites

  • Node.js 18 or later (includes npm)
  • Python 3.11 or later
  • Git 2.x or later
  • Windows 10/11 with PowerShell 5.1+ or Linux with bash 4+
  • An AI coding agent such as OpenCode, Claude Code, or Cursor
1

Run the one-command installer for your platform

The installer sets up all 62 skill files, ChromaDB memory, MCP server configuration, and supporting tooling. On Windows use PowerShell; on Linux use bash.

# Windows (PowerShell)
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.ps1 | iex

# Linux
bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.sh)
2

Skills-only install (no ChromaDB or MCP)

If you only want the 62 skill files without the memory stack, use the lightweight installer.

# Windows
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install-skills.ps1 | iex

# Linux
bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install-skills.sh)
3

Set execution policy on Windows if needed

If PowerShell blocks the installer script, allow local scripts to run with this one-time command.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
4

Optionally obtain a free NVIDIA API key

OpenCode defaults to the Go runtime and works without an external API key. For enhanced model access, visit https://build.nvidia.com to get a free key.

5

Start your agent with memory capture

Launch OpenCode using the provided wrapper script to enable automatic session memory saving to ChromaDB.

# Windows
.\run-opencode.ps1

# Linux — reload shell after install then start
source ~/.bashrc
opencode

Shokunin Examples

Client configuration

Example MCP server block for the ChromaDB memory server installed by Shokunin, used in claude_desktop_config.json or opencode config.

{
  "mcpServers": {
    "memory": {
      "command": "python",
      "args": ["-m", "chromadb_mcp"],
      "env": {}
    }
  }
}

Prompts to try

Example prompts that activate Shokunin's skill-based guidance or memory tools.

- "Use the docker skill to write a multi-stage Dockerfile for a Node.js app with BuildKit caching."
- "Activate the auth-architect skill and design a JWT authentication flow for my API."
- "Use the test-commander skill to write integration tests for this Express route."
- "Search my memory for previous decisions about database schema design."
- "Run the code-review skill on this pull request diff."

Troubleshooting Shokunin

pip install fails on Ubuntu 24.04 with PEP 668 externally managed environment error

The installer handles this automatically using --break-system-packages. If you run the installer manually and hit this error, add --break-system-packages to your pip command or use a virtual environment: python3 -m venv ~/.venv && source ~/.venv/bin/activate.

ChromaDB memory tools are not available in the MCP client

The full installer (not skills-only) must be used to set up ChromaDB. Confirm ChromaDB installed by running 'python3 -c "import chromadb"'. On Linux you may need build-essential and python3-dev: 'sudo apt-get install -y build-essential python3-dev'.

Skills do not auto-activate in the agent

Skills activate based on trigger keywords in the agent's CLAUDE.md or AGENTS.md. Verify these files were created in your project or home directory by the installer. The agent must be restarted after installation for the skill files to be detected.

Frequently Asked Questions about Shokunin

What is Shokunin?

Shokunin is a Model Context Protocol (MCP) server that 職人 shokunin 62 ai agent skills for opencode, claude code, cursor, windsurf. chromadb memory, mcp servers, declarative self-updates. multi-model, open source, zero cost. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Shokunin?

Follow the installation instructions on the Shokunin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Shokunin?

Shokunin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Shokunin free to use?

Yes, Shokunin is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "shokunin": { "command": "npx", "args": ["-y", "shokunin"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Shokunin?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides