Skip to main content
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
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/popup-studio-ai/bkit-claude-code --skill btwコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... name btw classification workflow classification-reason Manages /btw command lifecycle: record, list, analyze, promote, stats. User-driven workflow with CRUD on btw-suggestions.json deprecation-risk none effort medium description 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
argument-hint /bkit:btw {suggestion} | /bkit:btw list | /bkit:btw analyze | /bkit:btw promote {id} | /bkit:btw stats user-invocable true allowed-tools ["Read","Write","Edit","Glob","Grep","Bash"]
/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 .bkit-memory.json 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.total count
Respond: "Recorded btw-{NNN}: {truncated suggestion}. Use /btw list to 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-create to 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 .bkit-memory.json for current phase/featureskill-create : /btw promote triggers skill-create workflowskill-needs-extractor : /btw analyze results feed into gap analysisCTO 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 = true and 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 turnsCTO 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.
このリポジトリの他の Skills bkend.ai authentication — email/social login, JWT tokens, RBAC, session management.
Triggers: bkend auth, bkend login, bkend signup, bkend JWT, bkend RBAC
bkend.ai project tutorials (todo to SaaS) and common error troubleshooting.
Triggers: bkend tutorial, bkend cookbook, bkend troubleshooting
bkend.ai database — CRUD, column types, filtering, sorting, relations, indexing.
Triggers: bkend table, bkend CRUD, bkend column, bkend relation, bkend data
