Agent-Skills.md

Agent Skills: Submit a Plain Bug Report

Submit a bug report for the Plain framework. Use when the user wants to report a bug, error, or unexpected behavior. Collects context and creates a GitHub issue.

UncategorizedID: dropseed/plain/plain-bug

Repository

dropseed/plain
dropseed
80318

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dropseed/plain/tree/HEAD/.claude/skills/plain-bug

Skill Files

Browse the full folder contents for plain-bug.

Download Skill

Loading file tree…

.claude/skills/plain-bug/SKILL.md

Skill Metadata

Name
plain-bug
Description
Submit a bug report for the Plain framework. Use when the user wants to report a bug, error, or unexpected behavior. Collects context and creates a GitHub issue.

Submit a Plain Bug Report

1. Get bug details from the user

Ask the user for:

  • Title (required) — a short summary of the bug
  • Description (required) — what happened and how to trigger it.

Keep it concise but include whichever of these are available:

  • Reproduction steps — a minimal code snippet or command sequence that triggers the bug. Most valuable when the bug is reproducible.
  • Actual error — the traceback or unexpected output verbatim (trimmed to the relevant parts).
  • Root cause / fix — if you have high-confidence insight, include it. Helps maintainers triage faster.

Not every bug will have all three — a feature that's missing or behaves incorrectly may just need a clear description.

2. Collect environment info

Run these commands to auto-detect environment details:

uv run plain --version

uv run python --version

uname -s -r

3. Confirm with user

Show the user the full issue title and body before submitting. Do NOT submit without explicit approval.

4. Submit via gh

Create the issue using the GitHub CLI:

gh issue create --repo dropseed/plain --title "<title>" --body "<body>"

The body should follow this format:

<user's bug description>

## Environment

- Plain: <version>
- Python: <version>
- OS: <uname output>

---

*Submitted via the `/plain-bug` skill.*

5. Report the result

Show the issue URL returned by gh so the user can follow up.

Guidelines

  • No private info — Don't include file paths, env vars, API keys, secrets, database URLs, or other project-specific details. Only include Plain/Python versions, OS, and the bug description.
  • Confirm before submitting — Always show the full issue body to the user and get approval before creating.
  • No label needed — Maintainers will triage and label the issue.