linear-report

Generate weekly Linear activity reports grouped by milestone, label, cycle, and contributor.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/lety-ai/lety-skill-hub --skill linear-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-report
Source: https://github.com/lety-ai/lety-skill-hub/tree/main/plugins/linear-report/skills/linear-report
Command: npx skills add https://github.com/lety-ai/lety-skill-hub --skill linear-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates creation of consistent, data-driven weekly activity reports from Linear, removing manual aggregation of completed, in-progress, cancelled, and carried-over issues so teams can quickly see progress and blockers.

Core Features & Use Cases

  • Structured weekly summaries: Groups completed and in-progress work by milestone, label, cycle, and contributor and surfaces key metrics like total issues and story points.
  • Flexible date parsing: Accepts natural language week references (this week, last week, week of ...) and converts them to concrete YYYY-MM-DD boundaries with Monday as the week start.
  • Data-driven analysis: Computes carried-over items, contributors, most active labels, and milestone progress, and omits empty sections for concise output.
  • Save and publish: Renders a strict Markdown report and saves it as a Linear document while updating a project summary for Reports & Communications.
  • Use Case: Product managers and engineering leads generate sprint recaps, stakeholder summaries, and weekly project health reports.

Quick Start

Ask the skill: "Generate a weekly Linear report for project Lety 2.0 for last week."

Frequently Asked Questions about linear-report

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

FAQPage Schema
How do I generate a weekly project report from Linear without manual aggregation?

Generate weekly Linear reports by automatically querying project milestones, cycles, and issues to summarize completed, in-progress, and cancelled work into a structured Markdown document. This removes manual data aggregation by grouping items by contributor and label.

Can I use natural language dates like last week to generate Linear sprint reports?

Yes, natural language date references like this week or last week are parsed into concrete YYYY-MM-DD boundaries with Monday as the week start. This allows you to generate sprint summaries for specific date ranges without manual date formatting.

What is included in a Linear weekly activity report for project management?

A Linear weekly activity report includes completed, in-progress, cancelled, and carried-over issues grouped by milestone, label, cycle, and contributor. It surfaces key metrics like total issues and story points while omitting empty sections for concise output.

Does the weekly report save back into Linear as a project document?

Yes, the report is rendered as strict Markdown and saved directly as a Linear document while updating the project summary for Reports & Communications. This ensures the weekly project health report is accessible within Linear.

What are the limitations of automating Linear milestone reporting for carried-over issues?

Automated Linear milestone reporting computes carried-over issues and milestone progress but outputs a static Markdown report. It relies on querying project, milestone, cycle, status, label, and issue endpoints without dynamically modifying issue statuses.