How do I install the Btw skill?

Run npx skillmds@latest add ww-w-ai/btw in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Btw?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

ww-w-ai (@ww-w-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Btw by ww-w-ai — Agent Skill

Name: Btw
Author: ww-w-ai

Btw

Collect improvement suggestions during work. By-The-Way captures ideas, observations, and suggestions without interrupting the current workflow. Stores entries in .bkit/btw.json for later review and promotion. Use proactively when user says "btw", mentions a suggestion, improvement idea, or wants to note something for later. Triggers: btw, suggestion, improve, idea, feedback, note for later, by the way, 제안, 개선, 아이디어, 피드백, 참고로, 提案, 改善, アイデア, フィードバック, ちなみに, 建议, 改进, 想法, 反馈, 顺便说一下, sugerencia, mejora, idea, retroalimentación, amélioration, suggestion, idée, retour, Verbesserung, Vorschlag, Idee, Feedback, miglioramento, suggerimento, idea, feedback Do NOT use for: bug reports (use issues), task tracking (use PDCA)

ww-w-ai 025b0d9 3.4 KB Updated Sep 17, 2026

File contents

BTW (By-The-Way) Skill

Capture improvement suggestions on the fly without disrupting your workflow

Commands

Command	Description	Example
`/btw "text"`	Record a new suggestion	`/btw "Consider adding input validation to user form"`
`/btw list`	Show all collected suggestions	`/btw list`
`/btw analyze`	Analyze and categorize suggestions	`/btw analyze`
`/btw promote [id]`	Promote suggestion to PDCA feature	`/btw promote 3`

How It Works

Recording a Suggestion

Read .bkit/btw.json (create if it does not exist)
Append a new entry with:
- id: Auto-incrementing integer
- text: The suggestion text
- timestamp: ISO 8601 date string
- context: Current file or feature being worked on
- status: pending (default)
- category: Auto-detected (perf, ux, refactor, security, docs, other)
Write the updated array back to .bkit/btw.json using write_file

Storage Format

{
  "entries": [
    {
      "id": 1,
      "text": "Consider caching API responses for /users endpoint",
      "timestamp": "2026-04-09T14:30:00Z",
      "context": "src/api/users.js",
      "status": "pending",
      "category": "perf"
    }
  ]
}

Listing Suggestions

Read .bkit/btw.json
Display entries in a table sorted by newest first
Show status indicators: pending, promoted, dismissed

Analyzing Suggestions

Read all entries from .bkit/btw.json
Group by category
Identify patterns and recurring themes
Suggest which items to prioritize
Estimate effort for each (low/medium/high)

Promoting to PDCA Feature

Read the specified entry by ID
Create a new PDCA plan document: docs/01-plan/features/{slug}.plan.md
Pre-fill the plan with the suggestion details
Update the entry status to promoted
Inform user to continue with /pdca design {slug}

Category	Detection Keywords
`perf`	cache, speed, optimize, slow, performance, latency
`ux`	user, UI, UX, interface, experience, accessibility
`refactor`	refactor, cleanup, simplify, DRY, extract, reorganize
`security`	security, auth, validation, sanitize, XSS, CSRF
`docs`	document, README, comment, explain, JSDoc
`other`	Everything else

Integration with PDCA

BTW feeds into the Act phase:

Collect suggestions during Do phase with /btw "..."
Review collected items with /btw list
Analyze patterns with /btw analyze
Promote actionable items with /btw promote [id]
Continue with standard PDCA flow for promoted items

---name: btwdescription: Collect improvement suggestions during work. By-The-Way captures ideas, observations, and suggestions without interrupting the current workflow. Stores entries in .bkit/btw.json for later review and promotion. Use proactively when user says "btw", mentions a suggestion, improvement idea, or wants to note something for later. Triggers: btw, suggestion, improve, idea, feedback, note for later, by the way, 제안, 개선, 아이디어, 피드백, 참고로, 提案, 改善, アイデア, フィードバック, ちなみに, 建议, 改进, 想法, 反馈, 顺便说一下, sugerencia, mejora, idea, retroalimentación, amélioration, suggestion, idée, retour, Verbesserung, Vorschlag, Idee, Feedback, miglioramento, suggerimento, idea, feedback Do NOT use for: bug reports (use issues), task tracking (use PDCA)---# BTW (By-The-Way) Skill> Capture improvement suggestions on the fly without disrupting your workflow## Commands| Command | Description | Example ||---------|-------------|---------|| `/btw "text"` | Record a new suggestion | `/btw "Consider adding input validation to user form"` || `/btw list` | Show all collected suggestions | `/btw list` || `/btw analyze` | Analyze and categorize suggestions | `/btw analyze` || `/btw promote [id]` | Promote suggestion to PDCA feature | `/btw promote 3` |## How It Works### Recording a Suggestion1. Read `.bkit/btw.json` (create if it does not exist)2. Append a new entry with: - `id`: Auto-incrementing integer - `text`: The suggestion text - `timestamp`: ISO 8601 date string - `context`: Current file or feature being worked on - `status`: `pending` (default) - `category`: Auto-detected (`perf`, `ux`, `refactor`, `security`, `docs`, `other`)3. Write the updated array back to `.bkit/btw.json` using `write_file`### Storage Format```json{ "entries": [ { "id": 1, "text": "Consider caching API responses for /users endpoint", "timestamp": "2026-04-09T14:30:00Z", "context": "src/api/users.js", "status": "pending", "category": "perf" } ]}```### Listing Suggestions1. Read `.bkit/btw.json`2. Display entries in a table sorted by newest first3. Show status indicators: pending, promoted, dismissed### Analyzing Suggestions1. Read all entries from `.bkit/btw.json`2. Group by category3. Identify patterns and recurring themes4. Suggest which items to prioritize5. Estimate effort for each (low/medium/high)### Promoting to PDCA Feature1. Read the specified entry by ID2. Create a new PDCA plan document: `docs/01-plan/features/{slug}.plan.md`3. Pre-fill the plan with the suggestion details4. Update the entry status to `promoted`5. Inform user to continue with `/pdca design {slug}`## Categories| Category | Detection Keywords ||----------|--------------------|| `perf` | cache, speed, optimize, slow, performance, latency || `ux` | user, UI, UX, interface, experience, accessibility || `refactor` | refactor, cleanup, simplify, DRY, extract, reorganize || `security` | security, auth, validation, sanitize, XSS, CSRF || `docs` | document, README, comment, explain, JSDoc || `other` | Everything else |## Integration with PDCABTW feeds into the Act phase:1. Collect suggestions during Do phase with `/btw "..."`2. Review collected items with `/btw list`3. Analyze patterns with `/btw analyze`4. Promote actionable items with `/btw promote [id]`5. Continue with standard PDCA flow for promoted items

Frequently asked questions

Btw

File contents

BTW (By-The-Way) Skill

Commands

How It Works

Recording a Suggestion

Storage Format

Listing Suggestions

Analyzing Suggestions

Promoting to PDCA Feature

Categories

Integration with PDCA

Related skills

Frequently asked questions

How do I install the Btw skill?

What does the Btw skill do?

Is Btw safe to use?

Which AI agents work with Btw?

Is Btw free to use?

Who published Btw?