How does this skill handle session history?

It uses the GitHub CLI to create private gists of your local Claude session files and links them directly to Linear issues, ensuring a full audit trail of the conversation.

What is the benefit of the structured issue description?

It ensures every task includes a root cause analysis, specific implementation steps, and clear success criteria, which significantly reduces ambiguity during handoffs.

Does this skill require external tools?

Yes, it utilizes the GitHub CLI (gh) for gist creation and the Linear MCP server to interact with your Linear projects and issues.

When should I create a Linear issue instead of coding directly?

Create an issue for work requiring multiple sessions, complex architectural decisions, tasks needing research, or when work is being deferred for later.

Linear Project Management & Context Sync

Name: Linear Project Management & Context Sync
Author: mshuffett

bymshuffett

0•

Herramientas de Colaboración

Streamlines task management by creating structured Linear issues and attaching full session transcripts via GitHub Gists.

The Linear Workflow skill provides a rigorous framework for managing tasks and preserving developmental context within Claude Code. It establishes clear guidelines for when to document work versus implementing directly, enforces a comprehensive documentation structure for issues, and automates the process of attaching full session transcripts to Linear tasks using GitHub Gists. This ensures seamless handoffs between development sessions and team members, creating a robust audit trail for complex architectural decisions and implementation steps.

Características Principales

01Structured issue templates with context, analysis, and implementation details

02Logic-based decision framework for issue creation vs. direct implementation

030 GitHub stars

04Standardized labeling for infrastructure, bugs, and research-needed tasks

05Deep integration with Linear MCP tools for listing and updating tasks

06Automated session context preservation via private GitHub Gists

Casos de Uso

01Handing off technical context to team members with full conversation transcripts

02Documenting complex architectural changes that require multiple sessions

03Tracking infrastructure improvements and bug fixes within a structured project workflow

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles linear-workflow

For use in Claude.ai and ChatGPT