Shokunin skill
Sixty-two engineering skills and persistent ChromaDB memory for OpenCode and Claude Code, with no external servers.
- 112 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The installer edits the shell profile, adds a scheduler task and installs `pip` packages with `--break-system-packages`.
- Scripts are downloaded and executed in one line through `irm | iex` or `curl`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/shokuninDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The installer edits the shell profile, adds a scheduler task and installs `pip` packages with `--break-system-packages`.
- Scripts are downloaded and executed in one line through `irm | iex` or `curl`.
This is third-party code. Review the repository files before installing.
What it does
Shokunin installs 62 skills across 10 areas: infrastructure (docker, kubernetes, terraform), backend, frontend, mobile, quality, content, documents, productivity, agent work and system skills. Each skill carries decision tables, common mistakes, production checklists and sources, and some include scripts and templates. The skills come with ChromaDB memory: an MCP server with 12 tools (`store_context`, `search_context`, `multi_search_context`, `continue_session`, `verify_file_path` and more) keeps context across sessions, searches by vectors, BM25 and time, and old entries fade with a 30-day half-life. Data lives in `~/.shokunin/memory/`. Installers exist for Windows (PowerShell) and Linux (bash).
Who it is for. Developers on OpenCode and Claude Code who want a ready set of engineering skills and cross-session memory without cloud services.
Good fit when
- The agent forgets decisions from earlier sessions and context should be stored locally.
- A project needs a Dockerfile or Kubernetes manifests built from a vetted checklist.
- Before an interface ships, several quality skills should review it in a row.
- One set of skills is installed on Windows and on a Linux server.
Not a fit when
- One or two skills are enough and the full installer changes the environment more than needed.
- The environment is centrally managed and the PowerShell profile or scheduler cannot be changed.
- A local database memory is forbidden by data rules.
Example request
Search memory for how we set up CI last session and rewrite the Dockerfile as a multi-stage build using the `docker` skill.Limitations
The full installer changes the system: the PowerShell profile, a Windows scheduler task for weekly cleanup and memory backup, and the OpenCode configuration. On Ubuntu 24.04 it uses `pip` with `--break-system-packages`. It needs Node.js 18, Python 3.11 and Git, plus `python3-pip` and a compiler for ChromaDB on Linux. Installation runs through `irm | iex` or `bash <(curl ...)`, so read the scripts first. A skills-only route without memory exists as `install-skills.ps1` and `install-skills.sh`. The project's primary environment is OpenCode rather than Claude Code.
How to disable. Delete the `~/.shokunin/` folder, the skills from the agent's skills folder and Shokunin entries in the OpenCode configuration. Remove the Windows scheduler task or cron entry by hand.
FAQ
Which commands install the full set?
On Windows: `irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.ps1 | iex`. On Linux: `bash <(curl -sL https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.sh)`.
Where is memory stored?
In `~/.shokunin/memory/` on your machine. There is no cloud, telemetry or subscription.
How do I continue a particular session?
Run `python ~/.shokunin/scripts/chroma-helper.py session list 5`, then `session continue` with the id: the full context loads.
What does `verify_file_path` do?
This MCP tool checks whether paths from old memory still exist before the agent relies on them. Memory counts as a claim at the time of writing, not as a fact.
Can I install only the skills?
Yes. The scripts `install-skills.ps1` and `install-skills.sh` install skills without ChromaDB and MCP.
Discussion
No questions or reviews yet.
Related
SkillsOver twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
A coding agent for the terminal, browser and CI across 38 model providers, with cross-session memory, MCP, skills and hooks.
Codex Settings skills
Codex CLI Skills & Profiles
A Codex CLI plugin with twelve skills: deep research, pull request review, image generation and session handoff
Context Engine: code search and memory for an agent
Context Engine
A skill that teaches an agent to query the Context Engine code index and symbol graph before reading files directly
CKB, the Code Knowledge Backend, turns a codebase into a queryable knowledge base: symbols, impact, owners, dead code and risks.
Dozens of mizchi's agent skills: frontend audits, AWS, Cloudflare, SQL, Playwright and OpenTelemetry, installed one by one
README in short
A table of 10 skill areas, the contents of the install, a section on the v4.2.3 memory system and requirements for Windows and Linux. Skills are named by task: `docker`, `kubernetes`, `auth-architect`, `code-review`.