New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Shokunin Update

by EliasOulkadi in EliasOulkadi/shokunin

Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem.

MITAuto-check passed

Install Shokunin Update

skills CLI
$ npx skills add EliasOulkadi/shokunin --skill shokunin-update -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install EliasOulkadi/shokunin shokunin-update --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/EliasOulkadi/shokunin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pack/skills/shokunin-update .claude/skills/shokunin-update && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shokunin-update
GitHub stars
114
Token cost
~1.8k tokens
SKILL.md length
765 words
Files
1
Skills in repo
49
Repo updated
First seen
Licence
MIT

At a glance

Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem.

  • Works in 5 steps: Load the manifest → Check status → Plan changes → …
  • Verify the ecosystem
  • SKILL.md covers Workflow, When to use this skill, Do NOT and Error Handling, plus 4 more sections
  • Calls python

What it does

Shokunin Update is an agent skill from EliasOulkadi/shokunin. Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem. Use this when user asks to update, fix, sync, or verify the ecosystem.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It works with Chroma. The repository describes itself as: 職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cursor, Windsurf. ChromaDB memory, MCP servers, declarative self-updates. Multi-model, open source, zero cost. The licence is MIT.

When your agent uses it

  • Verify the ecosystem

Example prompts

  • “/shokunin-update”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): opencode

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Load the manifest
  2. Check status
  3. Plan changes
  4. Apply with confirmation
  5. Rollback if needed

What it can do on your machine

Read from SKILL.md and the folder at commit 4c68e5b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Shokunin Update loads about 1.8k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 765 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from EliasOulkadi/shokunin at commit 4c68e5b, republished under its MIT licence (© EliasOulkadi). 765 words, ~1,752 tokens.

Download SKILL.mdSave it as .claude/skills/shokunin-update/SKILL.md (or your agent's skills folder).
name
shokunin-update
description
Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem. Use this when user asks to update, fix, sync, or verify the ecosystem.
compatibility
opencode
triggers
update ecosystem, sync ecosystem, fix ecosystem, verify ecosystem, shokunin update, ecosystem status, check drift, update skills, repair ecosystem, ecosystem…
negatives
update skill content, create skill, memory operations, session management
license
MIT
metadata.version
1.0.0
metadata.workflow
system
metadata.audience
developers

Note: The shokunin-update.ps1 script lives in .pack/scripts/ and is deployed to ~/.shokunin/scripts/ by the installer.

Shokunin Update System

Maintains the Shokunin ecosystem by detecting drift between the declarative manifest and the actual filesystem state.

Workflow

1. Load the manifest

Read ~/.shokunin/shokunin.json. This is the single source of truth. Every component, path, hash, and template is defined here.

2. Check status

Run shokunin-update.ps1 status to detect drift:

  • OK: hash matches manifest
  • MISSING: file doesn't exist but manifest expects it
  • PROTECTED: data files (chroma_db, sessions) that must never be modified

Report results to the user with counts.

3. Plan changes

Run shokunin-update.ps1 plan to see what would change without applying anything.

Show the user a clear summary of what will be created, modified, or left alone.

4. Apply with confirmation
powershell
& "$env:USERPROFILE\.shokunin\scripts\shokunin-update.ps1" apply -Confirm

This automatically:

  1. Backs up each file to ~/.shokunin/backups/<timestamp>/
  2. Applies changes
  3. Saves update event to ChromaDB
  4. Runs memory-healthcheck.ps1 to verify
5. Rollback if needed
powershell
& "$env:USERPROFILE\.shokunin\scripts\shokunin-update.ps1" rollback -Timestamp 20260514-120000

When to use this skill

  • User notices something broken in the ecosystem
  • User wants to add/remove/modify a component
  • User asks "is everything up to date?"
  • Pre-commit or pre-PR verification

Do NOT

  • Modify files in protected groups (chroma_db, sessions, logs, backups)
  • Apply changes without user confirmation
  • Edit the manifest without understanding every field

Error Handling

CauseFix
shokunin.json manifest is missing or malformedValidate JSON syntax with Test-Json. If missing, run installer ~/.shokunin/install.ps1 to regenerate from template. Report exact parse error line if malformed.
File hash mismatch but content is identicalEncoding difference (CRLF vs LF) or trailing whitespace. Normalize line endings with .pack/scripts/normalize-eol.ps1 before re-checking.
Backup directory exceeds disk quotaOld backups accumulate over time. Retention policy: keep last 5 backups. Purge older directories with Remove-Item -Recurse.
Protected file group modified by applyA bug or misconfiguration in the manifest marked a protected path as writable. Abort immediately. Rollback from backup. Fix manifest before retry.
Rollback target timestamp not foundBackup was purged by retention policy or never created. Cannot recover that point in time. Run status to assess current state and manually fix drift.
Powershell execution policy blocks the scriptSystem execution policy set to Restricted
ChromaDB save during apply step failsMCP server is down or ChromaDB collection is locked
  • ~/.shokunin/scripts/validate-skills.ps1 — Validates all installed skills for required sections, size, and referenced script existence
  • ~/.shokunin/scripts/shokunin-update.ps1 — Drift detection, manifest-driven update apply, rollback, and status reporting

Sources

  • PowerShell 5.1 documentation (learn.microsoft.com/en-us/powershell/scripting) — execution policy, file hashing, and error handling
  • ChromaDB Python client documentation (docs.trychroma.com) — collection management and persistence
  • Semantic Versioning 2.0.0 (semver.org) — version comparison logic used in drift detection
  • Git documentation on plumbing commands (git-scm.com/docs/git-hash-object) — content-addressable storage pattern inspiration
  • "Infrastructure as Code" by Kief Morris (O'Reilly, 2nd Edition, 2020) — drift detection and reconciliation patterns
  • NIST SP 800-88 Guidelines for Media Sanitization — secure file overwrite patterns used in backup rotation
Show full SKILL.md (271 more words)Show less

Anti-Patterns

PatternProblemFix
Running apply without running plan firstChanges are applied without user awareness of what will be modifiedAlways run plan → show summary → get confirmation → then apply.
Modifying protected paths directly instead of through manifestData loss: chroma_db, sessions, logs get overwritten and cannot be recoveredNever touch paths under the protected group. If they need changes, update the manifest logic, not the files.
Hand-editing the manifest without understanding every fieldA typo in a path or hash field cascades into false drift positives or corrupted applyUse the declarative format. Every path must be absolute. Every hash must be SHA-256. Validate with Test-Json after edits.
Ignoring drift warnings for long periodsDrift accumulates, making later applies riskier and harder to roll backRun status weekly. Schedule via Task Scheduler: shokunin-update.ps1 status > ~/.shokunin/logs/drift.log.
Restoring from backup without verifying backup integrityA corrupted backup restores corrupted filesBefore rollback, verify backup checksums against the original manifest hashes. Abort if mismatch.
Running apply while another apply is in progressRace condition on backup/restore directories causing incomplete stateUse a lock file: ~/.shokunin/.apply-lock. If lock exists and process is alive, wait or abort. Stale lock (>30 min) can be removed.

Checklist

  • Verify shokunin.json is valid JSON and all component paths resolve
  • Run shokunin-update.ps1 status — 0 MISSING, no crashes
  • Run shokunin-update.ps1 apply — all components sync without errors
  • Verify MCP server starts: python ~/.shokunin/memory/mcp-server.py responds to tools/list
  • Verify chroma-helper.py CLI works: python ~/.shokunin/scripts/chroma-helper.py count
  • Verify all 62 skills present in .config/opencode/skills/
  • Verify templates match installed files (no drift)
  • Verify AGENTS.md version matches shokunin.json version
  • Run memory-healthcheck.ps1 — all tests pass
  • Run alidate-skills.ps1 — 0 failures

© EliasOulkadi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .pack/skills/shokunin-update of EliasOulkadi/shokunin.

Open the folder on GitHubat commit 4c68e5b

Compare with similar skills

Shokunin Update next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shokunin Update compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shokunin Update this skillEliasOulkadi/shokunin114—~1.8kAutomated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k7 repos~2.3kAutomated safety check: PassMIT
CLIP Image-Text MatchingOrchestra-Research/AI-Research-SKILLs13k7 repos~1.7kAutomated safety check: PassMIT
MemPalace MemoryMemPalace/mempalace60k—~2.7kAutomated safety check: PassMIT
Blockify Integrationiternal-technologies-partners/blockify-agentic-data-optimization315—~6.2kAutomated safety check: NotesCustom licence
Agent Memory Systemsomer-metin/skills-for-antigravity163—~731Automated safety check: PassApache-2.0

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 7 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed

  • CLIP Image-Text Matching

    Orchestra-Research/AI-Research-SKILLs

    Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.

    13k GitHub starsUsed in 7 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed

  • MemPalace Memory

    MemPalace/mempalace

    Gives an agent a local memory palace over MCP: verbatim conversation memory, semantic search and a temporal knowledge graph, with a per-session recall protocol.

    60k GitHub stars~2.7k tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Blockify Integration

    iternal-technologies-partners/blockify-agentic-data-optimization

    Process documents with Blockify API to create optimized IdeaBlocks for RAG.

    315 GitHub stars~6.2k tokensUpdated 5 mo ago
    AI & LLM EngineeringAuto-check: notes

  • Agent Memory Systems

    omer-metin/skills-for-antigravity

    Memory is the cornerstone of intelligent agents. An agent skill from omer-metin/skills-for-antigravity.

    163 GitHub stars~731 tokensUpdated 8 mo ago
    Agent WorkflowsAuto-check passed

  • Fleet Agent

    Qredence/agentic-fleet

    Context-aware development assistant for AgenticFleet with auto-learning and dual memory (NeonDB + ChromaDB).

    111 GitHub stars~994 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed

More from EliasOulkadi/shokunin

All 49 skills in this repo

  • CI CD

    EliasOulkadi/shokunin

    Design CI/CD pipelines for GitHub Actions, GitLab CI, and CircleCI with matrix builds, test sharding, caching, Docker layer caching, OIDC auth, deployment strategies (rolling, blue-green, canary)…

    114 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check: notes

  • Component Forge

    EliasOulkadi/shokunin

    Build production-grade components for React, Vue 3, and Svelte 5 with all states (loading, empty, error, success, idle), TypeScript strict, WCAG 2.2 accessibility, server components (RSC), and…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes

  • DB Admin

    EliasOulkadi/shokunin

    PostgreSQL database administration — backup/restore (pgdump, PITR, WAL archiving), health monitoring (connections, bloat, cache hit ratio, dead tuples), connection pooling (PgBouncer), replication…

    114 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check: notes

  • DB Sculptor

    EliasOulkadi/shokunin

    Design database schemas with Prisma/Drizzle, PostgreSQL index strategy (B-tree, GIN, GiST, BRIN, Hash), query optimization (EXPLAIN ANALYZE), migration safety (expand/contract, zero-downtime), and…

    114 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check: notes

  • Docker

    EliasOulkadi/shokunin

    Optimize Docker images with multi-stage builds, distroless bases, BuildKit cache mounts, multi-arch builds, compose watch, security hardening (non-root, seccomp, capabilities drop), and…

    114 GitHub stars~3.8k tokensUpdated 6 days ago
    Auto-check: notes

  • Error Handler

    EliasOulkadi/shokunin

    Design error handling, structured logging, and observability with OpenTelemetry (traces, metrics, logs), error classification, recovery patterns (retry with jitter, circuit breaker, bulkhead…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes

Works with

Questions about Shokunin Update

What does Shokunin Update do?

Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem. Shokunin Update is an agent skill from EliasOulkadi/shokunin. Detect drift, plan updates, and apply changes to the Shokunin AI Ecosystem.

When should I use Shokunin Update?

Shokunin Update fits situations like: verify the ecosystem.

How do I install Shokunin Update in Claude Code?

Run `npx skills add EliasOulkadi/shokunin --skill shokunin-update -a claude-code`. Or copy the skill folder (.pack/skills/shokunin-update in EliasOulkadi/shokunin) into .claude/skills/shokunin-update in your project. Claude Code loads it when a task matches its description.

How do I install Shokunin Update in Codex?

Run `npx skills add EliasOulkadi/shokunin --skill shokunin-update -a codex`. Or copy the skill folder (.pack/skills/shokunin-update in EliasOulkadi/shokunin) into .agents/skills/shokunin-update in your project. Codex loads it when a task matches its description.

Can I use Shokunin Update in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EliasOulkadi/shokunin --skill shokunin-update -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shokunin-update, .gemini/skills/shokunin-update, .github/skills/shokunin-update and .opencode/skills/shokunin-update in your project.

What does Shokunin Update need to run?

Going by SKILL.md and its folder, Shokunin Update needs the command-line tools its instructions call (python). Our summary lists: Python 3. Compatibility (from SKILL.md): opencode.

Does Shokunin Update access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shokunin Update safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shokunin Update use?

Shokunin Update is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shokunin Update use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shokunin Update?

Skills that share tags, products or a category with Shokunin Update: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars), MemPalace Memory (MemPalace/mempalace, 60k stars) and Blockify Integration (iternal-technologies-partners/blockify-agentic-data-optimization, 315 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shokunin Update?

EliasOulkadi (a GitHub user) maintains it in EliasOulkadi/shokunin, which has 114 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 5, 2026.

Source: EliasOulkadi/shokunin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.