Agent skill

Pdca

by twhsi in twhsi/skills

Create Chinese monospaced compass-style PDCA or CAPD problem-solving cards using East-West-South-North-Center layout, full-width and half-width spaces, diagonal Unicode arrows, and strict Chinese…

No licenceAuto-check passedDevelopment

Install Pdca

skills CLI
$ npx skills add twhsi/skills --skill pdca -a claude-code

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

GitHub CLI
$ gh skill install twhsi/skills pdca --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/twhsi/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pdca .claude/skills/pdca && 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
pdca
GitHub stars
259
Token cost
~1.2k tokens
SKILL.md length
458 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

Create Chinese monospaced compass-style PDCA or CAPD problem-solving cards using East-West-South-North-Center layout, full-width and half-width spaces, diagonal Unicode arrows, and strict Chinese…

  • Works in 6 steps: Extract the center problem as a phrase… → Decide whether the loop is CAPD or PDCA… → Fill the four directions → …
  • Codex needs to turn a problem
  • SKILL.md covers Core Rules, Compass Mapping, Arrow Rules and Output Template, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pdca is an agent skill from twhsi/skills. Create Chinese monospaced compass-style PDCA or CAPD problem-solving cards using East-West-South-North-Center layout, full-width and half-width spaces, diagonal Unicode arrows, and strict Chinese character limits. Use when Codex needs to turn a problem, incident, decision tradeoff, root-cause analysis, improvement cycle, or CAPD/PDCA workflow into a square text diagram, Hermes/Discord-ready card, or Chinese 方位九宮圖 with center ◎, north Plan, east Do, south Check, west Action, and four diagonal transition arrows.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Root cause analysis. It works with Discord. The repository describes itself as: AI Agent Skills for Chinese Knowledge Workers: iMandalArt, FIRE, planning, and publishing workflows for Claude Code, Codex, and LLM agents.

When your agent uses it

  • Codex needs to turn a problem
  • Decision tradeoff
  • Root-cause analysis
  • Improvement cycle

Example prompts

  • “/pdca”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Extract the center problem as a phrase of 8 Chinese characters or fewer.
  2. Decide whether the loop is CAPD or PDCA from the user's starting point.
  3. Fill the four directions
  4. Compress each phrase until it fits the requested width.
  5. Render a single text code block with full-width spacing and arrows.
  6. If helpful, add a brief note after the diagram listing the cycle order and any assumptions.

What it can do on your machine

Read from SKILL.md and the folder at commit 287d0f4. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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.

Context cost

Pdca loads about 1.2k tokens when it runs. Until then it costs about 130 tokens; SKILL.md has 458 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 458 words (~1,191 tokens).

“Use this skill to transform a problem into a Chinese text diagram shaped like a compass: North, East, South, West, four diagonal arrows, and a center ◎ core. The output should feel like a fixed-width visual card, not a prose…”

— opening of SKILL.md by twhsi
name
pdca

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/pdca of twhsi/skills.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 287d0f4

Compare with similar skills

Pdca 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.

Pdca compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pdca this skilltwhsi/skills259—~1.2kAutomated safety check: PassNone
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT
Review PRapache/shardingsphere21k—~6.4kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Review PR

    apache/shardingsphere

    Review Apache ShardingSphere or user-authorized downstream pull requests and PR discussions from public or authorized repository evidence.

    21k GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed

More from twhsi/skills

All 18 skills in this repo
  • Compiles notes, outlines, PDFs or BIRD and iMandalArt content into an eight-page mini book, with upright page PDFs, a reading PDF, an editable DOCX and an A4 landscape print sheet.

    259 GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.

    259 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.

    259 GitHub stars~688 tokensUpdated 2 mo ago
    Auto-check passed
  • Turns source material into a pure-text 3x3 iMandalArt 2.2 card with a five-character center and eight labeled surrounding angles, laid out with hard line breaks.

    259 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check passed
  • Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links.

    259 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Todays Daily Plan

    twhsi/skills

    Write spoken daily planning notes into an Obsidian Mandala Grid day-plan Markdown file.

    259 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Pdca

What does Pdca do?

Create Chinese monospaced compass-style PDCA or CAPD problem-solving cards using East-West-South-North-Center layout, full-width and half-width spaces, diagonal Unicode arrows, and strict Chinese…. Pdca is an agent skill from twhsi/skills. Create Chinese monospaced compass-style PDCA or CAPD problem-solving cards using East-West-South-North-Center layout, full-width and half-width spaces, diagonal Unicode arrows, and strict Chinese character limits.

When should I use Pdca?

Pdca fits situations like: Codex needs to turn a problem; decision tradeoff; root-cause analysis; improvement cycle.

How do I install Pdca in Claude Code?

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

How do I install Pdca in Codex?

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

Can I use Pdca 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 twhsi/skills --skill pdca -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdca, .gemini/skills/pdca, .github/skills/pdca and .opencode/skills/pdca in your project.

What does Pdca need to run?

SKILL.md names no scripts, command-line tools or credentials: Pdca is instructions for the agent only.

Does Pdca 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 Pdca 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 Pdca use?

No licence was found for Pdca or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Pdca use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Pdca?

Skills that share tags, products or a category with Pdca: Code Design Rationale Investigator (cursor/plugins, 10k stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars) and Root Cause Debugging (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pdca?

twhsi (a GitHub user) maintains it in twhsi/skills, which has 259 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 21, 2026.

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