skills.rest
GainInsightDev
GainInsightDevOFFICIAL
Explore all skills by this author →
WebsiteGitHub

af-manage-work-state

Manage work state and Linear issues across session boundaries.

Updated Feb 8, 2026
Search Tags:#workflow#context management#task management#issue tracking#linear#session recovery
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-manage-work-state
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: af-manage-work-state
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-manage-work-state
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-manage-work-state

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines task management, issue tracking, and context preservation across development sessions, preventing data loss and ensuring continuity.

Core Features & Use Cases

  • Task Management: Start, continue, and complete tasks, linking them to external issue trackers like Linear.
  • Context Preservation: Manages work state across session boundaries and context compaction using persistent files (current-task.md, plan files, todos).
  • Issue Tracking: Integrates with Linear for issue creation, state updates, and commenting.
  • Use Case: When starting a new feature, use this Skill to create a Linear issue, update your local task state, and begin documenting implementation steps in a plan file, ensuring all progress is saved even if the AI context is reset.

Quick Start

Use the af-manage-work-state skill to start a new task with the Linear ID JCN-4.

Frequently Asked Questions about af-manage-work-state

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

FAQPage Schema
How do I preserve task context across AI session boundaries and compaction events?▼

To preserve task context across session boundaries, this Skill uses persistent files like `current-task.md` and plan files to save progress, ensuring continuity and preventing data loss when AI context is reset.

How do I manage Linear issues and update task state directly from my development workflow?▼

Managing Linear issues is handled by interacting with the Linear API via the `linearis` CLI or GraphQL, allowing you to create issues, update task state, and add comments directly within your workflow.

Do I need a Linear API key to track issues and manage work state?▼

Yes, you need a `LINEAR_API_KEY` to execute Linear operations for issue tracking and state transitions when managing your work state and task context.

What's the best way to start a new task and link it to an existing Linear issue?▼

The best way to start a new task is to specify a Linear ID, which initializes local task state in `current-task.md` and links your ongoing progress to the external Linear issue.

How does context management work when completing a development task?▼

Context management for completing tasks works by finalizing the persistent plan files and updating the linked Linear issue state via the API, ensuring all implementation steps are recorded and synchronized.

Related Skills

Explore More Software Engineering Skills→
GainInsightDevGainInsightDev

af-query-linear-api

Query the Linear API with GraphQL for issue tracking and workflow management.

Official
Advanced
blockscoutblockscout
229

implementation-plan

Generate implementation-plan.md and coding-task.md from an approved task-analysis.

Official
Intermediate
OKHP3OKHP3
2

okhp3-foundry-repo-creator

Convert AI-driven assets and ideas into standardized GitHub repositories.

Community
Advanced
mecolejrmecolejr

project_tasks

Create and manage persistent project tasks with state transitions and dependencies.

Community
Intermediate