Skill

control

Manages bkit automation levels (L0 manual to L4 full-auto), displays trust scores and guardrails status. Invoke via /control [status|level|pause|resume|trust] for workflow control.

automation

Install

npx claudepluginhub popup-studio-ai/bkit-claude-code --plugin bkit

Tool Access

This skill is limited to using the following tools:

ReadWriteGlobGrepBashAskUserQuestion

Preview

> User-invocable skill for managing bkit automation level and system status.

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars513

Forks130

Last CommitApr 13, 2026

Actions

View Source View Plugin View on GitHub View README

Control Skill

User-invocable skill for managing bkit automation level and system status.

Arguments

Argument	Description	Example
(none)	Show current status (same as `status`)	`/control`
`status`	Show automation level, trust score, guardrails	`/control status`
`level <0-4>`	Set automation level manually	`/control level 2`
`pause`	Pause all automation (equivalent to L0)	`/control pause`
`resume`	Resume to previous automation level	`/control resume`
`trust`	Show trust score details and history	`/control trust`

Automation Levels

Level	Name	Description	Approval Gates
L0	Manual	All actions require explicit user approval	Every phase transition
L1	Guided	Suggestions provided, user confirms each step	Every phase transition
L2	Semi-Auto	Routine transitions auto, key decisions gated	do->check, check->report, report->archive
L3	Auto	Most transitions auto, only destructive ops gated	report->archive
L4	Full-Auto	Fully automated PDCA cycle, minimal intervention	Initial feature approval only

Action Details

status (Default)

Display the current automation control state.

Read runtime control state from .bkit/runtime/control-state.json
Read trust score from .bkit/state/trust-score.json
Read active guardrails from lib/control/ configuration
Display formatted status panel

Output Format:

--- bkit Control Panel ----------------------------
Automation Level : L2 (Semi-Auto)
Trust Score      : 72/100
Active Guardrails: 8/8
Paused           : No
Features Active  : 2/3
---------------------------------------------------
Guardrails:
  [ON] Destructive operation detection
  [ON] Blast radius limiter (max 10 files)
  [ON] Loop breaker (max 5 iterations)
  [ON] Checkpoint auto-creation
  [ON] Permission escalation gate
  [ON] Stale feature timeout (7d)
  [ON] Context overflow protection
  [ON] Concurrent write lock
---------------------------------------------------

level <0-4>

Set the automation level manually.

Validate input is a number 0-4
Read current level from .bkit/runtime/control-state.json
If escalating (going higher), warn user about reduced oversight
If de-escalating, apply immediately without confirmation
Update .bkit/runtime/control-state.json with new level
Write audit log entry via lib/audit/audit-logger.js
Display confirmation with new level details

Escalation Rule: Level increases require explicit confirmation via AskUserQuestion. Level decreases are immediate (safe direction).

Level Mapping to Automation:

Level	automationLevel	Description
L0	manual	All manual
L1	guide	Guided suggestions
L2	semi-auto	Semi-automatic (default)
L3	auto	Mostly automatic
L4	full-auto	Fully automatic

pause

Pause all automation immediately.

Save current level to .bkit/runtime/control-state.json as previousLevel
Set level to L0 (Manual)
Set paused: true flag
Write audit log: automation_paused
Display confirmation: "Automation paused. All operations require manual approval."

resume

Resume automation to the previous level before pause.

Read previousLevel from .bkit/runtime/control-state.json
If not paused, display: "Automation is not paused."
Restore level to previousLevel
Clear paused flag
Write audit log: automation_resumed
Display confirmation with restored level

trust

Show trust score details and contributing factors.

Read trust score from .bkit/state/trust-score.json
Calculate score breakdown:
- PDCA completion rate (0-25 points)
- Match rate average (0-25 points)
- Error recovery rate (0-20 points)
- Session stability (0-15 points)
- User override frequency (0-15 points, inverse)
Display detailed breakdown

Output Format:

--- Trust Score Details ---------------------------
Overall Score: 72/100

Breakdown:
  PDCA Completion Rate  : 18/25  (72% cycles completed)
  Match Rate Average    : 22/25  (88% average)
  Error Recovery Rate   : 14/20  (70% recovered)
  Session Stability     : 12/15  (80% stable)
  User Override Freq    :  6/15  (40% override rate)
---------------------------------------------------
Level Recommendation: L2 (Semi-Auto)
  Score 0-30  -> L0 (Manual)
  Score 31-50 -> L1 (Guided)
  Score 51-70 -> L2 (Semi-Auto)
  Score 71-85 -> L3 (Auto)
  Score 86+   -> L4 (Full-Auto)
---------------------------------------------------

State Files

File	Purpose
`.bkit/runtime/control-state.json`	Runtime control state (level, paused, previousLevel)
`.bkit/state/trust-score.json`	Trust score and contributing metrics

Module Dependencies

Module	Function	Usage
`lib/control/automation-controller.js`	`getLevel()`, `setLevel()`	Read/write automation level
`lib/control/automation-controller.js`	`pause()`, `resume()`	Pause/resume automation
`lib/audit/audit-logger.js`	`writeAuditLog()`	Record control changes

Usage Examples

# Check current status
/control

# Set to Semi-Auto
/control level 2

# Pause all automation
/control pause

# Resume previous level
/control resume

# View trust score
/control trust