skills/link-pr/SKILL.md
Link a GitHub pull request to a Lightsprint (ls) task. Use this after creating a GitHub PR for a task you're working on.
npx skillsauth add sprintsai/lightsprint-claude-code-plugin link-prInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Link a GitHub pull request to a Lightsprint task. This sets the task status to in_review and triggers an automated PR review.
lightsprint link-pr $ARGUMENTS
Usage: link-pr --task <taskId> --pr-url <prUrl>
--task <taskId>: The Lightsprint task ID--pr-url <prUrl> (or --pr <prUrl>): The full GitHub pull request URL (e.g., https://github.com/owner/repo/pull/123)CRITICAL — MANDATORY AUTO-LINK STEP: Every single time you create a GitHub PR (e.g., via gh pr create), you MUST IMMEDIATELY and AUTOMATICALLY link it. Do NOT wait for the user to ask — this is a required post-PR-creation step. Follow this exact flow:
lightsprint current-task --cc-pid $PPID to check for a linked task.lightsprint link-pr --task <taskId> --pr-url <prUrl> right away.Failure to do this breaks the team's workflow tracking. There is NO exception to this rule.
When lightsprint current-task returns no linked task after PR creation:
Step 1 — Check user preference: Run lightsprint config get link-pr.no-task-behavior.
always-skip, skip linking silently and inform the user: "Skipping PR linking (preference: always-skip). Run lightsprint config set link-pr.no-task-behavior prompt to re-enable."(not set) or prompt, continue to Step 2.Step 2 — Ask the user with three options:
No Lightsprint task is linked to this session. How would you like to proceed?
- Link existing task — Pick from your backlog/todo tasks
- Skip — Continue without tracking this time
- Always skip — Never ask again (you can re-enable later)
Option 1 — Link existing task:
lightsprint tasks --mine --status backlog,todo,in_progress --limit 10 to fetch the user's tasks.1. LS-024 — Fix login bug).lightsprint link-pr --task <selectedTaskId> --pr-url <prUrl>Option 2 — Skip: Inform the user the PR is not tracked in Lightsprint and move on.
Option 3 — Always skip: Run lightsprint config set link-pr.no-task-behavior always-skip, then inform the user: "PR linking will be skipped from now on. Run lightsprint config set link-pr.no-task-behavior prompt to re-enable."
testing
Update an existing Lightsprint (ls) task. Change its title, description, status, complexity, assignee, position, or dependencies.
tools
Remove a linked GitHub pull request from a Lightsprint (ls) task. Use this to unlink a PR that was previously linked to a task.
data-ai
List tasks from the Lightsprint (ls) workspace board. Use when you need to see what work is available.
testing
Get PR signals (CI checks, reviews, comments, deployments) for a task's linked PR. Use to inspect what CI and review activity has happened on a PR.