Thanks for your interest in improving Promptly!
- Bug reports: Something not working as expected
- Feature requests: Ideas for new capabilities
- Documentation: Unclear instructions or missing info
- Fork the repository
- Create a branch (
git checkout -b improve-detection) - Make your changes to
promptly.md - Test with Claude Code (
cp promptly.md ~/.claude/commands/) - Commit with a clear message
- Open a Pull Request
- Add new trigger phrases for existing modes
- Improve examples in the skill or README
- Add edge case handling
- Fix typos or clarify documentation
| File | Purpose |
|---|---|
promptly.md |
The skill — loaded when /promptly is invoked |
proactive-snippet.md |
CLAUDE.md snippet — enables always-on pattern detection |
README.md |
User-facing documentation |
CONTRIBUTING.md |
This file |
The skill (promptly.md) is a single markdown file with:
| Section | Purpose |
|---|---|
--- frontmatter |
Name, description, allowed tools |
<objective> |
What the skill does |
<context> |
File paths and variables |
<proactive_detection> |
Rules for when to offer prompt capture |
<process> |
Step-by-step instructions for Claude |
<examples> |
Show expected behavior |
<edge_cases> |
Handle unusual situations |
- Keep it simple — One file, minimal complexity
- Test your changes — Run
/promptlyand verify behavior - No new dependencies — The skill should remain self-contained
- Security conscious — Don't add tools that aren't needed (especially Bash)
Open an issue — happy to discuss ideas before you start coding.