dev-reports
Developer reporting skill for work documentation and communication. Use when writing journals, devlogs, status updates (22A/22B), progress reports, or documenting development work. Generates reports from git history or manual input.
When & Why to Use This Skill
Dev Reports is a specialized Claude skill designed to automate and standardize developer documentation. By transforming git commit history or manual notes into structured journals, devlogs, and status updates (including 22A/22B PPP formats), it ensures consistent communication across engineering teams and preserves vital technical context for long-term project health.
Use Cases
- Automated Git Journaling: Quickly summarize daily engineering tasks, refactors, and feature implementations by pulling data directly from recent git commits.
- Technical Devlogs: Document complex architectural decisions, technical debt, and learning milestones in a narrative format to build a searchable internal knowledge base.
- Standardized Status Reporting: Generate professional 'Progress, Plans, Problems' (PPP) reports for stakeholders and leadership using the 22A/22B templates to ensure transparency.
- Sprint Documentation: Consolidate fragmented work logs into comprehensive progress reports for sprint retrospectives and project post-mortems.
| name | dev-reports |
|---|---|
| description | Developer reporting skill for work documentation and communication. Use when writing journals, devlogs, status updates (22A/22B), progress reports, or documenting development work. Generates reports from git history or manual input. |
Dev Reports
Document and communicate development work. From git commits to polished reports.
Report Types
This skill supports multiple report formats:
| Type | When to Use | Trigger Phrases |
|---|---|---|
| Git Journal | Summarize work from commits | "journal this", "journal today's work" |
| Devlog | Narrative work documentation | "devlog", "write a devlog" |
| Status (22A) | Full Progress/Plans/Problems | "22A", "PPP update", "full status" |
| Status (22B) | Condensed status update | "22B", "quick status" |
How to Use This Skill
- Identify the report type from the request
- Load the appropriate template from
examples/:- Git journal → Read
examples/github-journal.md - Devlog → Read
examples/devlog.md - Status (full) → Read
examples/form-22a.md - Status (condensed) → Read
examples/form-22b.md
- Git journal → Read
- Follow the workflow in that template
- Generate the report in the specified format
Quick Reference
| Request | Template |
|---|---|
| "Journal this", "journal the last 4 hours" | examples/github-journal.md |
| "Write a devlog", "devlog update" | examples/devlog.md |
| "22A", "PPP update", "progress report" | examples/form-22a.md |
| "22B", "quick status" | examples/form-22b.md |
Report Purposes
Git Journal
Generates structured journal entries from git commit history. Great for:
- End of day summaries
- Sprint retrospectives
- Documenting refactors or features
Devlog
Narrative-style work logs with context and decisions. Great for:
- Explaining technical decisions
- Sharing learnings with the team
- Building institutional knowledge
Status Updates (22A/22B)
Structured Progress/Plans/Problems format. Great for:
- Team standups
- Leadership updates
- Weekly reports
Part of the dev-* Family
| Skill | Purpose |
|---|---|
dev-inquiry |
Technical investigation and decision-making |
dev-reason |
Problem-solving and debugging (future) |
dev-reports |
Work documentation and communication |