# 職人 · Shokunin

AI Engineering Ecosystem — 35 skills, ChromaDB memory, MCP servers, and automations. Zero cost, open source.

職人 (shokunin) means artisan in Japanese. These skills aim for that standard — every detail crafted, every edge case handled, every workflow automated.

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

Ecosystem

┌─────────────────────────────────────────────────┐
│  TERMINAL / EDITOR                              │
│  OpenCode · VS Code + Cline · WezTerm           │
├─────────────────────────────────────────────────┤
│  AGENT LAYER                                    │
│  35 skills · superpowers plugin · subagents     │
├─────────────────────────────────────────────────┤
│  INFRASTRUCTURE                                 │
│  MCP (filesystem, fetch, memory) · ChromaDB     │
├─────────────────────────────────────────────────┤
│  AI PROVIDERS                                   │
│  NVIDIA · OpenAI · Anthropic · Ollama (any model)         │
├─────────────────────────────────────────────────┤
│  SYSTEM (Windows 11)                            │
│  PowerShell profile · Task Scheduler · Cleanup  │
└─────────────────────────────────────────────────┘

Skills

Domain	Skills	Version
Infrastructure	docker, kubernetes, terraform, ci-cd, db-admin	v3.0
Backend	auth-architect, api-forge, db-sculptor, error-handler	v3.0
Frontend	component-forge, responsive-engine, motion-craft, landing-craft, ui-ux-pro-max	v3.0
Mobile	flutter, react-native	v3.0
Quality	test-commander, performance-profiler	v3.0
Content & Business	communication, content-marketing, business-proposals, seo-geo, translate-craft	v3.0
Documents	kami (PDF generator), portfolio-auto	v3.0
Productivity	git-workflow, windows-powershell, strategy, design, documentation, runbook-gen, finance, legal-counsel	v3.0
System	memory, chromadb, whendone-plus	v1.0

Each skill includes: trigger-optimized descriptions, procedural workflows, error handling, production checklists, anti-patterns, and cited sources. Advanced skills also include executable scripts, reference files, and reusable templates.

What You Get

Component	Purpose
35 SKILL.md files	Domain expertise that auto-activates
OpenCode config	MCP servers, subagents, superpowers plugin
ChromaDB memory	Persistent context across sessions
CLAUDE.md	Global AI instructions with mandatory memory
PowerShell profile	20+ aliases, oh-my-posh, autocomplete
Windows scheduler	Weekly cleanup & memory backup
Bookmarklet	Send web pages to OpenCode
Dashboard	Local ecosystem status viewer
WezTerm config	GPU terminal with Catppuccin theme
SQLite templates	Zero-install local database

Requirements

Windows 10/11
Node.js 18+
Python 3.11+
Git

Quick Start

# 1. Install
irm https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/install.ps1 | iex

# 2. Get a free NVIDIA API key
#    https://build.nvidia.com/

# 3. Start OpenCode
opencode

Commands

After installation, run opencode in any project directory. The AI agent loads your skills, searches memory from past sessions, and is ready to work.

opencode                              # Start AI session
gst, ga, gc "msg", gp, gl            # Git aliases
ni, nrd, nrb, nt                       # npm aliases
dps, dlog                               # Docker aliases
mkcd, touch, which, admin             # Utility aliases

License

MIT — free as in freedom, free as in zero cost.

shokunin