Skills
.Work. You
Rest

beads-linear-sync

Official

Sync Beads work into Linear safely

Software Engineering#beads#linear#task-tracking#dry-run#api-key#issue-sync
Authordarkmatter
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill removes the friction of keeping Beads task tracking and Linear planning aligned across Darkmatter repositories, so teams can move work between local issue databases and org-visible planning without manual mapping mistakes.

Core Features & Use Cases

  • Beads to Linear Mapping: Configures how repo-local Beads prefixes, statuses, priorities, and relations translate into Linear teams, projects, and issue fields.
  • Safe Sync Operations: Supports status checks and dry-run pull or push workflows before any real issue creation or updates happen.
  • Secret-Aware Operation: Uses approved secret stores for Linear API access instead of storing tokens in repo config.
  • Use Case: A repository owner wants to connect .beads/ issues to the LAB Linear team, verify the mappings, and preview the impact before syncing changes.

Quick Start

Ask the assistant to configure and dry-run Beads Linear sync for the repository using the LAB team and the approved Linear API key.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: beads-linear-sync
Download link: https://github.com/darkmatter/skills/archive/main.zip#beads-linear-sync

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.