Agent skill

Bkit Rules

by ww-w-ai in ww-w-ai/bkit-claude-code

Core rules for bkit — PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4…

Apache-2.0Auto-check passedAgent Workflows

Install Bkit Rules

skills CLI
$ npx skills add ww-w-ai/bkit-claude-code --skill bkit-rules -a claude-code

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

GitHub CLI
$ gh skill install ww-w-ai/bkit-claude-code bkit-rules --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/ww-w-ai/bkit-claude-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bkit-rules .claude/skills/bkit-rules && 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
bkit-rules
GitHub stars
601
Token cost
~2.3k tokens
SKILL.md length
889 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
Apache-2.0

At a glance

Core rules for bkit — PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4…

  • Works in 9 steps: PDCA Auto-Apply Rules → Level Auto-Detection → Agent Auto-Trigger Rules → …
  • Agent Workflows work in your project
  • SKILL.md covers 1. PDCA Auto-Apply Rules, 2. Level Auto-Detection, 3. Agent Auto-Trigger Rules and 4. Code Quality Standards, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bkit Rules is an agent skill from ww-w-ai/bkit-claude-code. Core rules for bkit — PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4 gates PDCA + Sprint auto-run). Triggers: bkit rules, core rules, methodology

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

It sits in Agent Workflows. The repository describes itself as: bkit Vibecoding Kit - PDCA methodology + Claude Code mastery for AI-native development. The licence is Apache-2.0.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/bkit-rules”

Requirements

  • Node.js
  • Docker
  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

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

  1. PDCA Auto-Apply Rules
  2. Level Auto-Detection
  3. Agent Auto-Trigger Rules
  4. Code Quality Standards
  5. Task Classification
  6. Output Style Auto-Selection (v1.5.1)
  7. Agent Teams Auto-Suggestion (v1.5.1)
  8. Agent Memory Awareness (v1.5.1)
  9. Plugin Hot Reload (v1.6.0)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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

Bkit Rules loads about 2.3k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 889 words of instructions outside code blocks.

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

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 ww-w-ai/bkit-claude-code at commit 85b4913, republished under its Apache-2.0 licence (© ww-w-ai). 889 words, ~2,308 tokens.

Download SKILL.mdSave it as .claude/skills/bkit-rules/SKILL.md (or your agent's skills folder).
name
bkit-rules
description
Core rules for bkit — PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4 gates PDCA + Sprint auto-run). Triggers: bkit rules, core rules, methodology
allowed-tools
Read, Glob, Grep
classification
workflow
classification-reason
Process automation persists regardless of model advancement
deprecation-risk
none
effort
low
user-invocable
false

bkit Core Rules

Automatically applied rules that don't require user commands.

1. PDCA Auto-Apply Rules

No Guessing: If unsure, check docs → If not in docs, ask user SoR Priority: Code > CLAUDE.md > docs/ design documents

Request TypeClaude Behavior
New featureCheck docs/02-design/ → Design first if missing
Bug fixCompare code + design → Fix
RefactoringCurrent analysis → Plan → Update design → Execute
Implementation completeSuggest Gap analysis
Template References
Document TypeTemplate Path
Plan${CLAUDE_PLUGIN_ROOT}/templates/plan.template.md
Design${CLAUDE_PLUGIN_ROOT}/templates/design.template.md
Analysis${CLAUDE_PLUGIN_ROOT}/templates/analysis.template.md
Report${CLAUDE_PLUGIN_ROOT}/templates/report.template.md

2. Level Auto-Detection

Detection Order
  1. Check CLAUDE.md for explicit Level declaration
  2. File structure based detection
Enterprise (2+ conditions met)
  • infra/terraform/ folder
  • infra/k8s/ or kubernetes/ folder
  • services/ folder (2+ services)
  • turbo.json or pnpm-workspace.yaml
  • docker-compose.yml
  • .github/workflows/ (CI/CD)
Dynamic (1+ conditions met)
  • bkend settings in .mcp.json
  • lib/bkend/ or src/lib/bkend/
  • supabase/ folder
  • firebase.json
Starter

None of the above conditions met.

Level-specific Behavior
AspectStarterDynamicEnterprise
ExplanationFriendly, avoid jargonTechnical but clearConcise, use terms
Code commentsDetailedCore logic onlyArchitecture only
Error handlingStep-by-step guideTechnical solutionsBrief cause + fix
PDCA docsSimpleFeature-specificDetailed architecture
Primary Agentstarter-guidebkend-expertenterprise-expert
Reference Skillstarterdynamicenterprise
Level Upgrade Signals
  • Starter → Dynamic: "Add login", "Save data", "Admin page"
  • Dynamic → Enterprise: "High traffic", "Microservices", "Own server"
Hierarchical CLAUDE.md Rules
project/
├── CLAUDE.md                 # Project-wide (always reference)
├── services/CLAUDE.md        # Backend work context
├── frontend/CLAUDE.md        # Frontend work context
└── infra/CLAUDE.md           # Infrastructure context

Rule: Area-specific rules > Project-wide rules


3. Agent Auto-Trigger Rules

Level-Based Selection

When user requests feature development:

  1. Detect project level
  2. Invoke appropriate agent automatically
Task-Based Selection
User IntentAuto-Invoke Agent
"code review", "security scan"bkit:code-analyzer
"design review", "spec check"bkit:design-validator
"gap analysis"bkit:gap-detector
"report", "summary"bkit:report-generator
"QA", "log analysis"bkit:qa-monitor
"pipeline", "which phase"bkit:pipeline-guide
Proactive Suggestions

After completing major tasks, suggest relevant agents.

Do NOT Auto-Invoke When
  • User explicitly declines
  • Task is trivial
  • User wants to understand process
  • Agent already invoked for same task

4. Code Quality Standards

Pre-coding Checks
  1. Does similar functionality exist? Search first
  2. Check utils/, hooks/, components/ui/
  3. Reuse if exists; create if not
Core Principles

DRY: Extract to common function on 2nd use SRP: One function, one responsibility No Hardcoding: Use meaningful constants Extensibility: Write in generalized patterns

Self-Check After Coding
  • Same logic exists elsewhere?
  • Can function be reused?
  • Hardcoded values present?
  • Function does only one thing?
When to Refactor
  • Same code appears 2nd time
  • Function exceeds 20 lines
  • if-else nests 3+ levels
  • Same parameters passed to multiple functions

5. Task Classification

Classify tasks to apply appropriate PDCA level:

ClassificationContent SizePDCA LevelAction
Quick Fix< 50 charsNoneExecute immediately
Minor Change50-200 charsLiteShow summary, proceed
Feature200-1000 charsStandardCheck/create design doc
Major Feature> 1000 charsStrictRequire design, user confirmation
Classification Keywords

Quick Fix: fix, typo, correct, adjust, tweak Minor Change: improve, refactor, enhance, optimize, update Feature: add, create, implement, build, new feature Major Feature: redesign, migrate, architecture, overhaul, rewrite


6. Output Style Auto-Selection (v1.5.1)

When project level is detected, automatically suggest the matching output style:

LevelSuggested StyleTrigger Condition
Starterbkit-learningLevel detected as Starter
Dynamicbkit-pdca-guideLevel detected as Dynamic
Enterprisebkit-enterpriseLevel detected as Enterprise
Auto-Selection Rules
  • On session start: Suggest output style matching detected level
  • On /starter init, /dynamic init, /enterprise init: Auto-suggest style for that level
  • On PDCA phase transitions: Suggest bkit-pdca-guide if not already active
  • User can override with /output-style at any time
Show full SKILL.md (350 more words)Show less
Available Output Styles
StyleBest ForKey Features
bkit-learningBeginners, learningLearning points, TODO(learner) markers, concept explanations
bkit-pdca-guidePDCA workflowsStatus badges, checklists, phase progress, gap analysis suggestions
bkit-enterpriseArchitecture decisionsTradeoff analysis, cost impact, deployment strategy, SOLID compliance

7. Agent Teams Auto-Suggestion (v1.5.1)

Suggest Agent Teams when conditions are met:

Suggestion Triggers
ConditionSuggestion
Major Feature (>= 1000 chars) AND Dynamic/Enterprise level"Agent Teams can parallelize PDCA phases. Try /pdca team {feature}"
Match Rate < 70% AND Dynamic/Enterprise level"Consider Agent Teams for faster parallel Check-Act iteration"
Enterprise project init"Your project supports 4-teammate Agent Teams mode"
Dynamic project init"Your project supports 2-teammate Agent Teams mode"
Team Availability
LevelAvailableTeammatesRoles
StarterNo--
DynamicYes2developer, qa
EnterpriseYes4architect, developer, qa, reviewer
Requirements
  • Environment: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
  • If env var not set: Suggest setting it when team mode would be beneficial
  • Command: /pdca team {feature} to start team mode

8. Agent Memory Awareness (v1.5.1)

Agent Memory is automatically active for all bkit agents. No user action required.

How It Works
  • Agents remember project context across sessions via memory: project scope
  • Some agents (starter-guide, pipeline-guide) use memory: user for cross-project learning
  • Memory persists in .claude/agent-memory/ (project) or ~/.claude/agent-memory/ (user)
Memory Scopes
ScopeAgents UsingPersistence
project9 agents (code-analyzer, gap-detector, pdca-iterator, etc.)Per-project, across sessions
user2 agents (starter-guide, pipeline-guide)Global, across all projects
Proactive Mention
  • On session start: "Agent Memory is active — agents remember context across sessions"
  • When agent is invoked: Agent may reference previous session context
  • No configuration needed — fully automatic

9. Plugin Hot Reload (v1.6.0)

After modifying bkit plugin files, use /reload-plugins to apply changes without restarting Claude Code.

  • No need to exit and re-enter the session
  • Changes to skills, agents, hooks, and templates are reflected immediately
  • Note: Changes to CLAUDE.md require /clear to fully refresh

Wildcard Permissions (CC 2.1.0+)

CC 2.1.0+ supports Bash(pattern*) wildcard permissions.

  • Bash(npm *) - Allow all npm commands
  • Bash(git log*) - Allow git log variants
  • Bash(node *) - Allow node execution
  • Bash(npx *) - Allow npx execution
Deny Recommendations
  • Bash(rm -rf*) - Deny recursive delete (dangerous)
  • Bash(git push --force*) - Deny force push
Configuration

Add to .claude/settings.json:

json
{
  "permissions": {
    "allow": ["Bash(npm *)", "Bash(git log*)"],
    "deny": ["Bash(rm -rf*)"]
  }
}

© ww-w-ai, Apache-2.0. 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 skills/bkit-rules of ww-w-ai/bkit-claude-code.

Open the folder on GitHubat commit 85b4913

Compare with similar skills

Bkit Rules 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.

Bkit Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bkit Rules this skillww-w-ai/bkit-claude-code601—~2.3kAutomated safety check: PassApache-2.0
Aicr Cross ReviewNVIDIA/aicr440—~15kAutomated safety check: PassApache-2.0
Self LearningKulaxyz/self-learning-skills963—~2.8kAutomated safety check: WarnMIT
Project Releaseswimmwatch/cloakbrowser-mcp164—~1.9kAutomated safety check: PassMIT
Perf Loopozontech/seq-db133—~1.6kAutomated safety check: PassApache-2.0
Devcontainer Devstacklok/toolhive-studio171—~3.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Official

    Multi-agent PR review using Claude Code, Codex, and CodeRabbit.

    440 GitHub stars~15k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Self Learning

    Kulaxyz/self-learning-skills

    Capture a hard-won "golden path" from the current session as a reusable Agent Skill, so future sessions start already knowing it.

    963 GitHub stars~2.8k tokensUpdated 26 days ago
    Agent WorkflowsAuto-check: warnings
  • Project Release

    swimmwatch/cloakbrowser-mcp

    Prepare, publish, verify, or recover a cloakbrowser-mcp release only when the user explicitly requests release work.

    164 GitHub stars~1.9k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Perf Loop

    ozontech/seq-db

    Autonomous performance-optimization loop for seq-db driven by seqbazooka.

    133 GitHub stars~1.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Devcontainer Dev

    stacklok/toolhive-studio

    Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).

    171 GitHub stars~3.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Local claude-code documentation reference (latest). An agent skill from olorehq/olore.

    104 GitHub stars~901 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from ww-w-ai/bkit-claude-code

All 44 skills in this repo
  • Audit

    ww-w-ai/bkit-claude-code

    View audit logs, decision traces, and session history for AI transparency.

    601 GitHub stars~1.6k tokensUpdated 13 days ago
    Auto-check: notes
  • Bkend Auth

    ww-w-ai/bkit-claude-code

    bkend.ai authentication — email/social login, JWT tokens, RBAC, session management.

    601 GitHub stars~937 tokensUpdated 13 days ago
    Auto-check: notes
  • Bkend Cookbook

    ww-w-ai/bkit-claude-code

    bkend.ai project tutorials (todo to SaaS) and common error troubleshooting.

    601 GitHub stars~891 tokensUpdated 13 days ago
    Auto-check: notes
  • Bkend Quickstart

    ww-w-ai/bkit-claude-code

    bkend.ai onboarding — MCP setup, resource hierarchy, tenant/user model, first project.

    601 GitHub stars~1.2k tokensUpdated 13 days ago
    Auto-check passed
  • Bkend Storage

    ww-w-ai/bkit-claude-code

    bkend.ai file storage — upload (presigned URL), download (CDN), visibility levels, buckets.

    601 GitHub stars~901 tokensUpdated 13 days ago
    Auto-check: notes
  • Bkit

    ww-w-ai/bkit-claude-code

    bkit plugin help - list available functions including /pdca (9-phase feature cycle), /sprint (8-phase feature container, v2.1.13), /control (Trust L0-L4 + SPRINTAUTORUNSCOPE), /bkit-explore, and 40+…

    601 GitHub stars~1.4k tokensUpdated 13 days ago
    Auto-check passed

Questions about Bkit Rules

What does Bkit Rules do?

Core rules for bkit — PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4…. Bkit Rules is an agent skill from ww-w-ai/bkit-claude-code.13), and Trust Level scope (L0-L4 gates PDCA + Sprint auto-run).

When should I use Bkit Rules?

Bkit Rules fits situations like: agent Workflows work in your project.

How do I install Bkit Rules in Claude Code?

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

How do I install Bkit Rules in Codex?

Run `npx skills add ww-w-ai/bkit-claude-code --skill bkit-rules -a codex`. Or copy the skill folder (skills/bkit-rules in ww-w-ai/bkit-claude-code) into .agents/skills/bkit-rules in your project. Codex loads it when a task matches its description.

Can I use Bkit Rules 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 ww-w-ai/bkit-claude-code --skill bkit-rules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bkit-rules, .gemini/skills/bkit-rules, .github/skills/bkit-rules and .opencode/skills/bkit-rules in your project.

What does Bkit Rules need to run?

SKILL.md names no scripts, command-line tools or credentials: Bkit Rules is instructions for the agent only. Our summary lists: Node.js; Docker. Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Bkit Rules 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 Bkit Rules 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 Bkit Rules use?

Bkit Rules is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bkit Rules use?

About 2.3k tokens (SKILL.md is roughly 9.2k 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 Bkit Rules?

Skills that share tags, products or a category with Bkit Rules: Aicr Cross Review (NVIDIA/aicr, 440 stars), Self Learning (Kulaxyz/self-learning-skills, 963 stars), Project Release (swimmwatch/cloakbrowser-mcp, 164 stars) and Perf Loop (ozontech/seq-db, 133 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bkit Rules?

ww-w-ai (a GitHub organization) maintains it in ww-w-ai/bkit-claude-code, which has 601 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on September 27, 2026.

Source: ww-w-ai/bkit-claude-code on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.