Control Skill Skill | Agent Skills

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

Agent Skills: Control Skill

Install this agent skill to your local

Skill Files