popup-studio-ai/bkit-claude-code/audit

Name: audit
Author: popup-studio-ai

Claude Code and agent skill by popup-studio-ai/bkit-claude-code

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

View audit logs, decision traces, and session history for AI transparency. ACTION_TYPES (19 entries) include PDCA events (phase_transition, gate_passed/failed, agent_spawned/completed/failed, rollback_executed, destructive_blocked) and Sprint events (sprint_paused, sprint_resumed, master_plan_created — v2.1.13). Triggers: audit, log, decision trace, history

Install

npx vskill@latest install popup-studio-ai/bkit-claude-code/audit

SKILL.md

Audit Skill

User-invocable skill for viewing audit logs, decision traces, and session history.

Arguments

Argument	Description	Example
(none)	Show recent audit log entries (same as `log`)	`/audit`
`log`	Show recent audit log entries (last 20)	`/audit log`
`trace <feature>`	Show decision traces for a feature	`/audit trace user-auth`
`summary`	Show daily/weekly audit summary	`/audit summary`
`search <query>`	Search audit logs by action type, feature, or date	`/audit search "phase_transition"`

Action Details

log (Default)

Display recent audit log entries.

Read today's audit log from .bkit/audit/YYYY-MM-DD.jsonl
If today's log is empty or has fewer than 20 entries, also read yesterday's log
Parse JSONL entries (one JSON object per line)
Display the last 20 entries in reverse chronological order
Format each entry with timestamp, action, feature, and details

JSONL Entry Schema:

json

{
  "timestamp": "2026-03-19T10:30:00.000Z",
  "action": "phase_transition",
  "feature": "user-auth",
  "from": "plan",
  "to": "design",
  "automationLevel": "semi-auto",
  "triggeredBy": "user",
  "details": "Plan approved, transitioning to Design"
}

Output Format:

--- Audit Log (Last 20 Entries) -------------------
[2026-03-19 10:30] phase_transition | user-auth
  plan -> design (Semi-Auto, user-triggered)
 
[2026-03-19 10:25] checkpoint_created | user-auth
  Checkpoint cp-1710842700000 before Design phase
 
[2026-03-19 10:20] automation_level_changed | -
  L1 -> L2 (trust score: 72)
...
---------------------------------------------------
Total entries today: 45

trace <feature>

Show decision traces for a specific feature.

Read decision trace files from .bkit/decisions/YYYY-MM-DD.jsonl
Filter entries matching the specified feature
Display chronological decision chain with rationale

Decision Trace Entry Schema:

json

{
  "timestamp": "2026-03-19T10:30:00.000Z",
  "feature": "user-auth",
  "decision": "advance_to_design",
  "rationale": "Plan document complete, matchRate N/A at this phase",
  "alternatives": ["request_plan_revision", "skip_to_do"],
  "chosenBecause": "Plan deliverable exists and passes validation",
  "automationLevel": "semi-auto",
  "confidence": 0.92
}

Output Format:

--- Decision Trace: user-auth ---------------------
[10:15] START -> pm
  Decision: Begin PDCA cycle
  Rationale: New feature request detected
 
[10:20] pm -> plan
  Decision: advance_to_plan
  Rationale: PRD document generated successfully
  Alternatives: [reject_prd, revise_scope]
  Confidence: 0.88
 
[10:30] plan -> design
  Decision: advance_to_design
  Rationale: Plan document complete, passes validation
  Alternatives: [request_plan_revision, skip_to_do]
  Confidence: 0.92
---------------------------------------------------
Total decisions: 3

summary

Show daily or weekly audit summary.

Read audit logs for the current day (and optionally past 7 days)
Aggregate by action type and count occurrences
Calculate key metrics:

Total actions recorded
Phase transitions count
Automation vs manual ratio
Error/recovery events
Average trust score change

Display formatted summary

Output Format:

--- Audit Summary (2026-03-19) --------------------
Total Actions       : 45
Phase Transitions   : 12
Checkpoints Created : 4
Errors Recorded     : 1
Recoveries          : 1
 
Action Breakdown:
  phase_transition       : 12 (27%)
  checkpoint_created     :  4 (9%)
  match_rate_recorded    :  8 (18%)
  automation_level_change:  2 (4%)
  iteration_completed    :  6 (13%)
  other                  : 13 (29%)
 
Automation Ratio: 67% auto / 33% manual
Trust Score Change: +3 (69 -> 72)
---------------------------------------------------
Weekly Trend (last 7 days):
  Mon: 32 actions | Tue: 45 actions | Wed: 28 actions
  ...

search <query>

Search audit logs by action type, feature name, or date range.

Parse the search query to determine filter type:

If query matches an action type (e.g., phase_transition), filter by action
If query matches a feature name, filter by feature
If query matches a date (YYYY-MM-DD), filter by date
Otherwise, perform full-text search across all fields

Read relevant JSONL files from .bkit/audit/
Apply filters and return matching entries (max 50 results)
Display results in chronological order

Search Examples:

bash

# Search by action type
/audit search "phase_transition"
 
# Search by feature name
/audit search "user-auth"
 
# Search by date
/audit search "2026-03-18"
 
# Full-text search
/audit search "error"

File Locations

Path	Format	Purpose
`.bkit/audit/YYYY-MM-DD.jsonl`	JSONL	Daily audit log entries
`.bkit/audit/summary/`	JSON	Pre-computed daily/weekly summaries
`.bkit/decisions/YYYY-MM-DD.jsonl`	JSONL	Decision trace entries

Module Dependencies

Module	Function	Usage
`lib/audit/audit-logger.js`	`readAuditLog()`	Read audit entries
`lib/audit/audit-logger.js`	`searchAuditLog()`	Search/filter entries
`lib/audit/decision-tracer.js`	`getDecisionTrace()`	Read decision traces

Retention Policy

Audit logs: 30-day retention, auto-cleanup via daily hook
Decision traces: 30-day retention, linked to audit logs
Total storage budget: 100MB (auto-prune oldest when exceeded)

Usage Examples

bash

# View recent log entries
/audit
 
# View decision trace for a feature
/audit trace user-auth
 
# View daily summary
/audit summary
 
# Search for phase transitions
/audit search "phase_transition"
 
# Search by feature
/audit search "user-auth"

Security

Security scanPassed, 95 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/audit/SKILL.md

Popularity

Repository stars: 585
Repository forks: 148
7-day trend score: 32

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 31 Jul 2026, 3 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/popup-studio-ai/bkit-claude-code/audit/badge)](https://verified-skill.com/skills/popup-studio-ai/bkit-claude-code/audit)

Something wrong with this skill or its page? Tell us.