# Workflow Log Bug

> Capture a bug report as a markdown file in the workflow inbox. Use when the user wants to log, note, or save a bug for later.

- Skill: `leeovery/workflow-log-bug` (Agent Skill)
- Install (CLI): `npx skillmds@latest add leeovery/workflow-log-bug`
- Raw SKILL.md: https://api.skillmd.com/api/skills/leeovery/workflow-log-bug/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: leeovery (https://skillmd.com/u/leeovery)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/leeovery/workflow-log-bug

---


This skill captures a bug report and writes it to the inbox.

If there's already conversation context about something broken, synthesise it straight into the file without asking questions. If this is a cold start, ask what's broken and have a natural back-and-forth to draw out the symptoms. Recognise when it has enough detail (typically 2-4 exchanges) and wrap up.

**Capture only — these are rules, not guidelines:**
- Do not read code or explore the codebase
- Do not search the web or fetch external resources
- Do not attempt to reproduce or validate the bug
- Do not suggest fixes or workarounds
- Do not diagnose root causes or theorise about what's wrong
- Do not propose solutions or next steps

When ready, generate a short kebab-case slug from the core symptom (e.g., `stale-cache-on-deploy`, `login-timeout`) and write the file:

```bash
mkdir -p .workflows/.inbox/bugs
```

**File:** `.workflows/.inbox/bugs/{YYYY-MM-DD}--{slug}.md` (use today's actual date)
- H1 title, prose body, 200-500 words
- No forced headings — let the content flow naturally
- Naturally cover symptoms, conditions, and impact as discussed
- Mention relevant codebase files if they came up

Confirm with a one-liner:

> *Output the next fenced block as a code block:*

```
Logged bug: {slug}
```

