| name | insights |
| description | Generate codebase activity summaries (daily/weekly/catchup/view) from Azure DevOps PRs, work items, local git, and optionally Confluence. Trigger when user says "/df:insights", asks "what happened", "codebase activity", "team summary", or wants a PR/commit roll-up. |
Insights
Multi-op skill. Dispatch on first word of $ARGUMENTS.
Dispatch
| Op | First word | Reference |
|---|
| daily | daily [date] | references/daily.md |
| weekly | weekly [date] | references/weekly.md |
| catchup | catchup | references/catchup.md |
| view | view (dashboard) | references/view.md |
Empty / unknown → ask user.
Data Sources
| Source | Tool | Data |
|---|
| Azure PRs | az repos pr list | PRs opened, merged, reviewed |
| Azure Work Items | az boards query | Tickets started, completed, in progress |
| Local Git | git log | Commits in current repo |
| Confluence | Atlassian MCP | Recently modified pages |
Workflow
- Parse op from
$ARGUMENTS
- Read corresponding
references/<op>.md
- Execute steps — collectors live in
${CLAUDE_SKILL_DIR}/collectors/, templates in ${CLAUDE_SKILL_DIR}/templates/, dashboard in ${CLAUDE_SKILL_DIR}/dashboard/
Prerequisites
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT
az login
Confluence integration: requires Atlassian MCP server. Skipped silently if absent.
Output Structure
.insights/
├── raw/
│ ├── prs.json # Azure PRs
│ ├── workitems.json # Azure work items
│ ├── commits.json # Local git commits
│ └── confluence.json # Confluence pages
├── 2025-01-08-insights.md # Daily reports
├── 2025-W02-insights.md # Weekly reports
└── dashboard.html # Generated dashboard
Notes
collectors/, templates/, dashboard/ infra unchanged — only the dispatch surface consolidated.- Monthly review uses
collectors/format-review.mjs --month YYYY-MM or the templates/monthly-review.md template.
