@verzth/skills
v1.8.1
Published
Custom Claude skills by verzth — install via npx, or via Claude Code plugin marketplace
Maintainers
Readme
What is this?
A plug-and-play skill registry for Claude Code, Cowork, and OpenClaw. Each skill extends the AI's behavior with domain-specific frameworks, workflows, and personality — installed with a single command.
Three install paths supported:
- npm CLI —
npx @verzth/skills install <name> - Claude Code plugin marketplace —
/plugin install <name>@verzth-skills - OpenClaw —
npx @verzth/skills install <name> --openclaw
Available skills
| Skill | Type | Description |
|-------|------|-------------|
| humanoid-thinking | single | Human cognitive framework — intuition-first, validated by logic |
| golang-developer | single | Go microservices development (Clean Architecture, gRPC, Wire DI) |
| pm-thinking | bundle | AI-First Product Management — pm-discover, pm-works, pm-decide |
| em-thinking | bundle | AI-First Engineering Management — em-plan, em-works, em-review |
| public-awareness | single | Artifact integrity guardrail — keeps internal working context out of public-facing artifacts |
| arch-diagram | single | Interactive diagram generator — editable flowcharts (Cytoscape.js), rich SVG sequence diagrams, ER/state/class via Mermaid |
Want something else? Request a skill →
Quick Start (npm)
npx @verzth/skills install humanoid-thinkingYou'll be prompted to choose where to install:
Where do you want to install?
1) Global → ~/.claude/skills/ (available in all projects)
2) Project → ./.claude/skills/ (current project only)
Choose [1/2]:Or skip the prompt with flags:
npx @verzth/skills install humanoid-thinking --global # all projects
npx @verzth/skills install humanoid-thinking --project # current project onlyUsage
# Install a specific skill
npx @verzth/skills install <skill-name>
# Install multiple skills
npx @verzth/skills install humanoid-thinking <other-skill>
# Install all available skills
npx @verzth/skills install --all
# List available skills
npx @verzth/skills listFlags
| Flag | Short | Description |
|------|-------|-------------|
| --global | -g | Install to ~/.claude/skills/ — available across all projects |
| --project | -p | Install to ./.claude/skills/ — scoped to current project only |
| --openclaw | -o | Install for OpenClaw with adapted content |
Flags can be combined: --openclaw --global installs adapted skill to ~/.openclaw/skills/.
When no scope flag is provided and the session is interactive, the CLI prompts you to choose. In non-interactive environments (CI/CD, piped input), it auto-detects based on whether .claude/ (or .openclaw/) exists in the current directory.
Install via Claude Code plugin marketplace
If you prefer the native plugin marketplace mechanism in Claude Code:
# Add this repo as a marketplace (one-time)
/plugin marketplace add https://github.com/verzth/skills.git
# Install any skill
/plugin install humanoid-thinking@verzth-skills
/plugin install golang-developer@verzth-skills
/plugin install pm-thinking@verzth-skills
/plugin install em-thinking@verzth-skillsUpdate later:
/plugin marketplace update verzth-skills
/plugin update <skill-name>@verzth-skillsMarketplace catalog: .claude-plugin/marketplace.json
Install for OpenClaw
# Global (recommended)
npx @verzth/skills install public-awareness --openclaw --global
# Project-scoped
npx @verzth/skills install public-awareness --openclaw --projectThe --openclaw flag adapts skill content at install time:
- Installs to
~/.openclaw/skills/or.openclaw/skills/ - Rewrites tool names:
Bash→exec,Write→write,Agent→sessions_spawn,TodoWrite→task tracker - Rewrites paths:
.claude/→.openclaw/,CLAUDE.md→AGENTS.md - Normalizes frontmatter: only
name,description, andversionare kept
Alternative Install Methods
# Install all
curl -fsSL https://raw.githubusercontent.com/verzth/skills/main/install.sh | bash
# Install specific skill
curl -fsSL https://raw.githubusercontent.com/verzth/skills/main/install.sh | bash -s -- humanoid-thinking# Install specific skill for OpenClaw
curl -fsSL https://raw.githubusercontent.com/verzth/skills/main/install.sh | bash -s -- --openclaw public-awarenessNote: curl installs change the install path but skip content adaptation (tool name rewrites). For fully adapted content, use
npx @verzth/skills install <name> --openclaw.
git clone https://github.com/verzth/skills.git /tmp/verzth-skills
cp -r /tmp/verzth-skills/skills/humanoid-thinking .claude/skills/humanoid-thinkingHow Skills Work
Claude Code and Cowork load skills from .claude/skills/ directories. Each skill is a folder containing a SKILL.md with instructions that shape how Claude thinks and responds.
Global (~/.claude/skills/) skills are active in every project on your machine. Project (./.claude/skills/) skills only activate when Claude is working in that specific project directory.
Upgrade-safe
The installer automatically backs up and restores your personality.md configuration when upgrading skills, so your personalized settings are never lost.
Skill: humanoid-thinking
The flagship skill. Makes Claude think with human-like common sense instead of exhaustively exploring every possibility.
What it does:
- Framework HATI (Human-Aware Thinking & Intuition) — a 4-step cognitive process: Tangkap → Intuisi → Validasi → Sampaikan
- Smart confirmation — asks follow-up questions only when genuinely ambiguous, not for things that are obvious from context
- Personality system — on first use, runs an onboarding flow where you name your agent, set communication style, language, and detail level. All preferences persist across sessions.
Example:
User: "Mau cuci mobil, enaknya jalan kaki atau naik mobil?"
Without skill: Analyzes both options, considers walking distance, pickup services, exercise benefits...
With skill: "Naik mobil — mobilnya harus dibawa ke sana."
Skill: golang-developer
An opinionated Go microservices development skill that enforces production-proven patterns across your entire Go codebase.
What it does:
- Clean Architecture — strict layering: entity → repository → service → handler, with Google Wire for compile-time DI
- gRPC + grpc-gateway — three-tier API design (Admin/Insider/Public) with buf for proto management and OpenAPI generation
- Production stack — GORM + MySQL, NATS JetStream for event streaming, Redis for caching and distributed locking
- Comprehensive references — covers entity patterns, repository patterns, service patterns, scheduler patterns, testing, infrastructure, and provider integration
Covers: scaffolding, code review, debugging, testing, and architecture guidance for Go microservices.
Skill: pm-thinking
A bundle that turns Claude into a virtual PM team. One install → 3 sub-skills: /pm-discover (researcher), /pm-works (senior PM), /pm-decide (strategist).
What it does:
- Forcing questions, not templates — each skill pushes you to answer sharp questions instead of filling out blank forms
- Markdown handoffs between skills —
discovery.mdfeeds/pm-works,prd.mdfeeds/pm-decide --review, nothing falls through the cracks - Tech-aware, not tech-decide — PMs understand technical impact (schema, API, backward compat) without making engineering decisions; clear boundary to a separate
engineer-managerskill - Multi-mode
/pm-decide—--prio(prioritization),--review(PRD review),--stakeholder(updates),--retro(post-launch reflection) - Numbered questions, anti-ambiguity — every question to the user is labeled (1/2/3 or a/b/c) so responses like "1a, 2c" stay precise and audit-friendly
Sprint flow: /pm-discover → /pm-works → /pm-decide --review → handoff to engineering → /pm-decide --stakeholder during build → /pm-decide --retro after ship.
Skill: em-thinking
A bundle that turns Claude into a virtual EM team. One install → 3 sub-skills: /em-plan (architect), /em-works (delivery prep), /em-review (reviewer + debugger). Companion to pm-thinking — picks up where PRD ends.
What it does:
- EDD as PRD's parallel (dual
.md+.htmloutput) —/em-planproducesedd.md+edd.html(Engineering Design Document) with risk tier (T0-T3), scope challenge, invariants, failure modes table, test strategy, and ASCII diagrams for component boundaries / data flow / state machine. HTML is self-contained (inline CSS, color-coded T0-T3 risk badges, ASCII diagram styling, TOC + breadcrumb, print-friendly) for human review - 15 cognitive patterns from canonical sources — State Diagnosis (Larson), Boring by Default (McKinley), Failure is Information (Allspaw/SRE), Make Change Easy (Beck), Conway's Law (Skelton/Pais), and more — applied as lens, not checklist
- Execution-ready handoff —
/em-workstranslates EDD into atomic tickets + worktree parallelization lanes + env/secrets spec + deploy plan artifact (artifact-only, doesn't execute — devops/release skill handles execution) - Auto-detect mode in /em-review — input contains PR ref → Mode A (code review, dual
.md+.htmloutput with severity-coded findings); stack trace / "bug" / "error" → Mode B (debug, hypothesis-driven, no blind fixes); ambiguous → asks - Role-based handoff (not skill-specific) — outputs reference role names (
engineer,security-reviewer,qa-reviewer,release-engineer/devops,pm) so they work across env conventions (verzth, soekarno, gstack, generic) - Numbered questions, anti-ambiguity — same pattern as pm-thinking
EM lifecycle flow: /em-plan → /em-works → engineer role → /em-review (Mode A approve → release; Mode B debug if production incident → loop back to /em-plan if architectural).
Inspired by gstack (Garry Tan, YC) for cognitive patterns + scope challenge discipline, and soekarno for multi-agent process + structured handoff philosophy.
Skill: public-awareness
A guardrail that keeps working context out of artifacts. Install it globally so every artifact-writing session automatically separates what's being built from how it's being built.
What it does:
- Channel rule — internal context (progress notes, uncertainty, process TODOs, session reasoning) belongs in conversation / TodoWrite / memory, never inside the artifact being built
- Covers all artifact types — websites, API specs, technical docs, database records, design specs, shared documents (Notion, Confluence, Google Docs), deployed code
- Language rule — the artifact's language follows the project audience, not the conversation language (e.g. prompter writes in Indonesian, product is an English website → content in English)
- Audience check — before writing, asks: "Is this content part of the artifact or about how we're building it?" When the target's visibility is unclear, asks before writing
Example:
Without skill: Writes
<!-- TODO: verify pricing with legal -->inside published HTML, or"_note": "still validating"inside a production JSON payloadWith skill: Keeps those notes in conversation; writes only intentional, finished content into the artifact
Skill: arch-diagram
Generates interactive system diagrams as self-contained .html files — open in any browser, no server, no build step.
What it does:
- Flowchart / architecture — fully editable Cytoscape.js canvas: drag nodes to rearrange, add/remove nodes and edges, rename labels inline, and drag any connection line to bend it into a curve. Auto-layout via dagre (LR/TD direction). Click any node to open a details sidebar with editable title, description, tech stack tags, and links
- Sequence diagrams — standalone custom SVG: gradient actor boxes with colored lifelines, phase bands with letter labels, numbered step circles, solid vs dashed arrow styles, and a legend — no Mermaid involved
- ER / State / Class diagrams — Mermaid-rendered with themed dark/light mode
- Export — SVG, PNG, and PDF from the toolbar
- Category color system — frontend (blue), backend (green), database (purple), cache (amber), queue (red), auth (pink), infra (cyan), external (gray)
When to use: any time the user wants to diagram, visualize, or document a system — even casual phrasing like "draw this", "show me how these connect", "map out my stack", or "make a diagram of my app".
Requirements
- Node.js 14+ (for
npx) - Claude Code or Cowork by Anthropic, or OpenClaw
FAQ
Can I use multiple skills at once? Yes. Install as many as you want — they work independently and don't conflict.
What happens when I upgrade a skill?
Your personalized settings (like personality.md) are automatically backed up and restored. You won't lose your configuration.
Global or project — which should I pick? Use global if you want the skill everywhere. Use project if you only want it in a specific repo, or if different projects need different configurations.
Can I uninstall a skill?
Just delete the skill folder from .claude/skills/ (project) or ~/.claude/skills/ (global). For OpenClaw, same pattern under .openclaw/skills/.
