ShipfoxHQ/shipfox / .agents/skills/implement-issue
implement-issue
VerifiedImplement a Linear issue when given a Linear issue ID or URL. Use when the user invokes /implement-issue or asks to implement, build, or complete a specific Linear issue from an issue key, issue ID, or Linear URL.
Implement an issue
Required input
Require the user to provide a Linear issue ID, issue key, or Linear issue URL before doing anything else. If the user did not provide one, ask for it and stop until they answer.
Context gathering
Before starting implementation, gather the full Linear context for the requested issue:
- Fetch the issue itself and its comments.
- Fetch all associated issues, including parent, child, related, blocked-by, blocking, duplicate, and any other linked Linear relationships available through the Linear tools.
- Fetch the project the issue belongs to, if any.
- Fetch all other issues in that project.
- Fetch every document linked from any fetched issue or project.
- Continue following newly discovered linked issues, projects, and documents until the useful context graph has been covered or there is a clear cycle/repetition.
Treat Linear as the source of truth for product intent, requirements, acceptance criteria, state, priority, ownership, and project context.
GitHub pull request context
If any fetched Linear issue links to GitHub pull requests, fetch each pull request before implementation:
- Read the pull request title, description, author, branch, review state, checks, and merge status.
- Fetch the diff for each pull request.
- Identify whether the pull request is merged, open, draft, closed unmerged, or blocked.
- Incorporate relevant already-implemented changes into the plan.
- Avoid duplicating work from merged or active pull requests unless the user explicitly asks for it.
Start work
Before making code changes:
- Set the requested Linear issue status to
In Progress. - Assign the issue to the current user.
- Confirm the local repository context and read AGENTS.md and the sources it routes to before editing.
- Create or update a concise implementation plan from the gathered context.
If assigning to the current user is ambiguous, identify the current user through the available Linear tool context. If that is not available, ask the user which Linear assignee to use before changing the assignee.
Implementation workflow
Implement the issue end to end using the repository's existing conventions.
- Inspect the relevant code before editing.
- Prefer the smallest implementation that satisfies the Linear requirements and project context.
- Include tests when the behavior, contract, or bug risk warrants them.
- Run focused validation first, then broader validation when the change touches shared behavior.
- Keep the Linear context in mind throughout, especially related issues and project-wide constraints.
If requirements conflict, are ambiguous, or force trade-offs, pause before implementation and offer the user the realistic options with the consequences of each. Continue only after the user chooses a direction.
Completion
When implementation is complete:
- Report the files changed and the behavior implemented.
- Report the validation commands run and their results.
- Call out any remaining risks, skipped checks, or follow-up work.
- Do not mark the Linear issue done unless the user explicitly asks for that status change.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 117k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |