// 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.
| 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. |
Ask the user for:
Keep it concise but include whichever of these are available:
Not every bug will have all three — a feature that's missing or behaves incorrectly may just need a clear description.
Run these commands to auto-detect environment details:
uv run plain --version
uv run python --version
uname -s -r
Show the user the full issue title and body before submitting. Do NOT submit without explicit approval.
ghCreate 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.*
Show the issue URL returned by gh so the user can follow up.
Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.
Captures and analyzes performance traces to identify slow queries and N+1 problems. Use when a page is slow, there are too many queries, or the user asks about performance.
Answer questions about the Plain framework by researching docs and source code. Use when asked "how do I...", "does Plain support...", or "how does X work?" questions.
Check overall database health — schema correctness and operational health. Use when asked to check the database, validate schema, optimize indexes, or diagnose Postgres problems.
Open a remote Python shell on a production machine via encrypted tunnel. Use when you need to inspect production data, debug issues, run queries, or transfer files.
Releases Plain packages with intelligent version suggestions and parallel release notes generation. Use when releasing packages to PyPI.