Agent skill · ma08
start-new-task
Initialize a new task folder with status.md, user_inputs/initial.md, user_inputs/input_artifacts/, task-progress-artifacts/, and task-progress-artifacts/scratchpad/. Supports GitHub issue URL inputs, Linear issue URL inputs, default Linear issue creation for trackerless starts, tracker-informed slugs, and machine/zellij metadata capture with optional live-session issue block sync.
What it needs
About 6k tokens when loaded.
What this skill does
Start New Task Create a task folder and capture durable metadata for machine, session, and tracker linkage. Invocation Shared Helpers Process Step 1: Determine Task Status Root 1. Check project CLAUDE.md for task-status-root:. 2. If missing, check project AGENTS.md. 3. Default to context/daily/. 4. Resolve date as YYYY-MM-DD. Step 2: Resolve Context Before Slugging Run: Use output fields: Task Slug Tracker Kind Tracker URL Tracker Human ID Tracker Title GitHub Issue (compatibility, when detected) Canonical Project Root Canonical Task Status Root Machine Coding Agent Agent Session ID Zellij Session Zellij Link Step 2A: Create Linear Tracker For Trackerless Starts If Tracker Kind is none, create a new Linear ticket before slugging unless the user explicitly asked for local-only/no-tracker work or named a different tracker. 1. Use the Linear skill / Linear MCP tools to create the issue. 2. Infer the most appropriate team/project/labels from local context when obvious; otherwise default to the normal personal workflow team and keep project unset. 3. Include the user's original description, concise goal, likely scope, and acceptance criteria in the Linear issue. 4. Assign to the user when that is the established workspace convention. 5. After creation, rerun resolvetaskcontext.py with the new Linear issue URL and use the resulting tracker-aware fields for all later steps. 6. If Linear tooling/auth is unavailable, continue in degraded local-only mode, record why no tracker was created in status.md, and tell the user. Skip this step only when: the original description already contains a GitHub or Linear tracker, the user explicitly says not to create a tracker, the user explicitly asks for a different tracking destination, or Linear creation is blocked and degraded local-only mode is the only viable path. Step 2B: Set the Codex Desktop Thread Title When running inside Codex Desktop and codexapp.setthreadtitle is available: 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/start-new-task