linear-todos

What This Skill Does

The linear-todos skill for OpenClaw is a powerful automation tool designed to bridge the gap between natural language interaction and your Linear project management workflow. Unlike passive notification systems, this is a source-execution skill; when you issue a command, the agent executes Python code directly from your local src/linear_todos/ directory. This allows for dynamic, context-aware management of your issues without relying on rigid, pre-built binary abstractions.

The skill handles everything from creating new tickets with complex metadata—such as natural language scheduling, priority assignment, and status tracking—to retrieving your active task list. Security is a primary focus: all interactions with Linear happen over HTTPS exclusively through the official GraphQL API (api.linear.app). No telemetry or third-party data tracking is included. If you choose to use the setup command, your credentials are stored locally in a restricted-permission JSON file (~/.config/linear-todos/config.json), though we highly recommend using environment variables for the best security posture.

Installation

To add this capability to your agent, use the OpenClaw hub CLI. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/avegancafe/linear-todos

Once installed, you can choose to run the interactive setup wizard to generate a configuration file, or simply export your LINEAR_API_KEY in your shell environment. If you opt for the configuration file, ensure your environment handles the ~/.config/linear-todos/ directory correctly, as the skill enforces strict file permissions (0o600) to protect your API keys.

Use Cases

• Contextual Planning: Turn a loose brainstorming session into actionable tickets without switching windows.
• Deadline Management: Use natural language dates (e.g., "next Tuesday", "end of day") to automatically schedule tasks within Linear.
• Status Synchronization: Quickly query your "In Progress" items to stay aligned with your team's velocity during stand-ups.
• Developer Workflow Automation: Pipe technical findings directly into Linear during the debugging process.

Example Prompts

1. "Create a new bug report in the Backend team's project: 'Memory leak in session parser' with high priority due by Friday at 5pm."
2. "Show me all tickets assigned to me that are currently in the 'In Progress' state."
3. "Move the task 'Refactor authentication module' to 'Done' and comment that it was finalized after the security audit."

Tips & Limitations

• Security: Always prefer using environment variables (LINEAR_API_KEY) over the persistent config file if you are working on a shared machine.
• Timezone: Ensure your system timezone is correctly configured. The skill uses this for calculating "end of day" deadlines, and will fall back to your USER.md settings if needed.
• Permissions: The skill only acts on resources your provided API key has access to. If you are hitting authorization errors, verify your Linear API token scopes.
• Atomicity: Since this runs Python code on-demand, avoid interrupting the process while it is mid-request to ensure your state remains consistent.