btw
By-The-Way: capture improvement ideas the moment they surface, without derailing the task in progress. Triggers: /bkit:btw, /bkit:btw list, /bkit:btw analyze, /bkit:btw promote, /bkit:btw stats, btw, suggestion, improve, idea, feedback
How do I install this agent skill?
npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill btwIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a productivity tool for capturing and managing development ideas. It records user suggestions to a local JSON file and provides workflows for analysis and promotion. A minor security risk exists regarding indirect prompt injection, as user-provided content is stored and later used to drive automated tasks like skill creation without explicit sanitization.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
/btw - By-The-Way Suggestion Collector
작업 중 "이거 스킬로 만들면 좋겠다", "이 패턴 자동화하면 좋겠다" 등의 개선 제안을 즉시 기록하고 관리하는 도구.
Commands
/btw {suggestion} - Record a suggestion
- Read
.bkit/btw-suggestions.json(create if not exists) - Generate next ID:
btw-NNN(zero-padded, sequential) - Create suggestion entry:
{ "id": "btw-001", "timestamp": "ISO-8601", "suggestion": "{user input}", "context": { "file": "{current working file if identifiable}", "pdcaPhase": "{current PDCA phase from getPdcaStatusView() or null}", "feature": "{current feature or null}" }, "category": "auto-detect", "status": "pending", "promotedTo": null, "priority": null, "teamContext": { "isTeamSession": false, "phase": "{PDCA phase or null}", "role": "{teammate role that discovered this, or 'user'}", "pattern": "{orchestration pattern or null}" } } - Auto-detect category from suggestion text:
skill-request: mentions "skill", "스킬", "자동화", "automate"bug-pattern: mentions "bug", "버그", "오류", "error", "fix"improvement: mentions "개선", "improve", "better", "refactor"documentation: mentions "문서", "doc", "설명", "explain"general: default
- Update
stats.totalcount - Respond: "Recorded btw-{NNN}: {truncated suggestion}. Use
/btw listto view all."
/btw list - List all suggestions
- Read
.bkit/btw-suggestions.json - Display table:
ID | Status | Category | Suggestion (truncated) ---------|----------|----------------|---------------------- btw-001 | pending | skill-request | @Flow 모델에서 옵션 목록을 자동... btw-002 | promoted | improvement | DataProxy 패턴에 검증 로직을... - Show summary: Total: N | Pending: N | Promoted: N | Dismissed: N
/btw analyze - Analyze suggestions for skill candidates
- Read all pending suggestions from
.bkit/btw-suggestions.json - Group by category and find patterns:
- Cluster similar suggestions (keyword overlap)
- Count frequency of similar topics
- Identify suggestions that map to existing bkit skills vs. new skill needs
- For each skill candidate:
- Estimate skill classification: workflow vs capability
- Suggest skill name and description
- Reference source suggestion IDs
- Output analysis:
Skill Candidates from /btw Analysis ===================================== 1. [NEW SKILL] hunikflow-validation (capability) Based on: btw-001, btw-005, btw-008 Frequency: 3 mentions Description: Validation pattern guide for @Flow entities 2. [EXISTING SKILL ENHANCEMENT] code-review Based on: btw-003 Suggestion: Add DataProxy-specific review rules - Save analysis timestamp to
stats.lastAnalyzed
/btw promote {id} - Promote suggestion to skill creation
- Find suggestion by ID in
.bkit/btw-suggestions.json - Validate status is "pending" (cannot promote already promoted/dismissed)
- Update suggestion:
status: "promoted"promotedTo: skill name (derived from suggestion)
- Trigger skill-create workflow with context from the suggestion:
- Pass suggestion text as skill description seed
- Pass context (file, feature) as project context
- Respond: "Promoted btw-{id} -> skill-create pipeline. Run
/skill-createto continue."
/btw stats - Show statistics
- Read
.bkit/btw-suggestions.json - Calculate and display:
/btw Statistics =============== Total suggestions: 12 By status: pending=8, promoted=3, dismissed=1 By category: skill-request=5, improvement=4, bug-pattern=2, general=1 Promotion rate: 25.0% Last analyzed: 2026-03-13T10:00:00Z Top keywords: @Flow(3), DataProxy(2), validation(2)
Data File: .bkit/btw-suggestions.json
Initialize with this structure if file does not exist:
{
"version": "1.0",
"suggestions": [],
"stats": {
"total": 0,
"promoted": 0,
"dismissed": 0,
"lastAnalyzed": null
}
}
Category Auto-Detection Rules
| Pattern | Category |
|---|---|
| skill, 스킬, automate, 자동화, command, 명령 | skill-request |
| bug, 버그, error, 오류, fix, 수정 | bug-pattern |
| improve, 개선, better, refactor, 리팩토링, optimize | improvement |
| doc, 문서, explain, 설명, readme, guide | documentation |
| (default) | general |
Integration Points
- PDCA Context: Reads the phase and feature through
getPdcaStatusView()(lib/pdca/status.js), which covers a phase that only its documents evidence..bkit/state/memory.json— the migrated.bkit-memory.json— carries the 9-phase pipeline status, not the PDCA phase. - skill-create:
/btw promotetriggers skill-create workflow - skill-needs-extractor:
/btw analyzeresults feed into gap analysis - CTO Team: Phase transition triggers btw summary (see below)
CTO Team Integration
When /btw is used during a CTO Team session (/pdca team):
Auto-Detection
- Check if team session is active via
.bkit/runtime/agent-state.json - If active: set
teamContext.isTeamSession = trueand populate phase/role/pattern - If not active: set
teamContext.isTeamSession = false(default behavior)
Phase Transition Hook
CTO Lead automatically reads btw-suggestions.json at every phase transition:
- 0 pending: Silent skip (no output, no turns spent)
- 1+ pending: Brief summary (top 3, category counts) in 1-2 turns
- CTO does NOT auto-promote — user decides via
/btw promote {id}
Session End
cto-stop.js hook outputs btw stats at session end:
- Total suggestions collected during session
- Category breakdown
- Promotion rate
teamContext Field
Added to each suggestion entry when recorded during a team session:
"teamContext": {
"isTeamSession": true,
"phase": "do",
"role": "user",
"pattern": "swarm"
}
This enables /btw analyze to group suggestions by PDCA phase and identify phase-specific patterns.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ww-w-ai/bkit-claude-code/btw">View btw on skillZs</a>