work-summary

Aggregate Git commits, GitHub Pull Requests, and Linear issues into a changelog-style work summary.

Updated Dec 24, 2024
One-click install
npx skills add https://github.com/BSteffaniak/nix-config --skill work-summary-bsteffaniak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: work-summary
Source: https://github.com/BSteffaniak/nix-config/tree/main/configs/opencode/skills/work-summary
Command: npx skills add https://github.com/BSteffaniak/nix-config --skill work-summary-bsteffaniak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, linear, python3, jq, mktemp, date, sort, wc, find, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of compiling a comprehensive summary of your work accomplishments across various platforms, saving you time and ensuring accuracy in your reports.

Core Features & Use Cases

  • Multi-Source Data Aggregation: Gathers data from Git commits, GitHub Pull Requests, and Linear issues.
  • Automated Identity Resolution: Identifies your unique user identity across all data sources.
  • Intelligent Deduplication: Merges related items (e.g., PRs, commits, issues) into single, coherent work units.
  • Interactive Review: Presents findings for your selection and allows for individual item review and refinement.
  • Use Case: Generate a weekly status report by automatically pulling together all your code contributions, merged PRs, and completed tasks from Linear, then present it in a polished, changelog-style format.

Quick Start

Use the work-summary skill to generate a summary of your accomplishments for the last week.

Frequently Asked Questions about work-summary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a weekly work summary from Git commits, GitHub PRs, and Linear issues?

To generate a weekly work summary, this Skill aggregates data from Git commits, GitHub Pull Requests, and Linear issues, automatically resolving your cross-platform identity and deduplicating related work items into a polished changelog-style report.

Does generating a work summary require specific command-line tools installed?

Yes, generating a work summary requires several command-line dependencies including git, gh, linear, python3, and jq, along with standard shell utilities like mktemp, date, sort, wc, and find to aggregate and process the data.

What is the best way to compile a changelog from multiple development platforms?

The best way to compile a changelog from multiple platforms is using an automated aggregation process that merges Git commits, GitHub PRs, and Linear issues, followed by an interactive review process to refine the output into a polished summary.

Can I review and edit the aggregated work items before the final report is generated?

Yes, you can review and edit aggregated work items before the final report is generated, as the Skill facilitates an interactive review process that presents findings for your selection and allows individual item refinement.

How does identity resolution work when aggregating work items across Git, GitHub, and Linear?

Identity resolution works by automatically identifying and matching your unique user identity across Git, GitHub, and Linear data sources, ensuring that all related work items are correctly attributed to you before deduplication.

Are there limitations to the automated deduplication of related work items in the summary?

While the Skill intelligently merges related items like PRs, commits, and issues into coherent work units, limitations may arise if cross-platform identity resolution fails to match your profiles, requiring manual selection during the interactive review phase.