ingest-linear

Ingest Linear issues, comments, and status changes into markdown vault files.

31|20|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-linear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest-linear
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/ingest-linear
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingests recent Linear activity (issues, comments, and status changes) into the vault so it can be queried and used by the knowledge graph and decision logging layers.

Core Features & Use Cases

  • Ingests Linear scope activity on demand (team or project) and writes one file per scope per day to External Inputs/Linear/<scope>/<YYYY-MM-DD>.md.
  • Keeps data in a deterministic, frontmatter-based vault format for downstream processing, session closure, and guardrails.
  • Use Case: When a user asks to capture a Linear team's work, run the ingestion to populate the vault for search and analysis.

Quick Start

Instruct the system to ingest a Linear scope (team or project) by calling the ingestion command and specifying the scope.

Frequently Asked Questions about ingest-linear

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

FAQPage Schema
How do I ingest Linear activity into a markdown vault?

You can ingest Linear activity into a markdown vault by running a command that captures team or project issues, comments, and status changes, writing them as daily markdown files to feed your knowledge graph.

What is the best way to automate Linear data ingestion for a knowledge graph?

Automating Linear data ingestion involves orchestrating Linear API calls to capture recent activity and delegating normalization to write deterministic, frontmatter-based markdown files into your vault for downstream processing.

How does daily Linear ingestion handle duplicate issues and comments?

Daily Linear ingestion handles duplicates through idempotency by writing one file per scope per day to a specific date path, overwriting the existing file if the ingestion is run again on the same day.

Can I capture Linear project status changes for specific date ranges?

Yes, you can capture Linear project status changes for specific date ranges by invoking the ingestion command with a scope argument and specifying the number of recent days to include.

Do I need a specific format for Linear issues imported into a decision log?

Linear issues imported into a decision log require a deterministic, frontmatter-based markdown format stored under External Inputs, ensuring the data can be queried by downstream knowledge graph and session closure layers.

What are the limitations of ingesting Linear activity on demand?

Limitations include writing data only at a daily granularity per scope and relying on the Linear MCP for data retrieval, which restricts ingestion to recent activity rather than real-time streaming or historical archives beyond the specified days.