One-click install
npx skills add https://github.com/me2resh/apexyard --skill start-ticket-me2resh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-ticket
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/start-ticket
Command: npx skills add https://github.com/me2resh/apexyard --skill start-ticket-me2resh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of blocked code edits when the ticket-first workflow gate is enforced, so you can proceed with safe, production-ready changes tied to an active tracker item.

Core Features & Use Cases

  • Declares an active ticket: Writes session marker files that allow the require-active-ticket.sh PreToolUse hook to permit Edit/Write on permitted code paths.
  • Validates ticket existence and state: Uses the configured tracker adapter (GitHub by default, or Linear/Jira/Asana/custom) to confirm the issue exists and warn if it appears closed.
  • Scopes the marker correctly across projects: Resolves a per-project marker under the ops fork’s .claude/session/tickets/<project> when the ticket’s repo is registered; otherwise uses the ops fallback marker at .claude/session/current-ticket.

Quick Start

Start an active coding session by running /start-ticket apexyard#41.

Frequently Asked Questions about start-ticket

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

FAQPage Schema
How do I unblock code edits when a ticket-first workflow gate is enforced?

To unblock code edits under a ticket-first workflow gate, you must declare an active tracker item tied to the appropriate repository scope. This generates a session marker that permits subsequent Edit and Write operations on validated code paths.

What is a session marker and how does it enable ticket-first development?

A session marker is a key/value metadata file written to your ops fork that records the active ticket's repo, number, title, URL, suggested branch, and start time. It enables ticket-first development by allowing PreToolUse hooks to validate and permit code editing actions.

Can I use GitHub issues to validate and start a multi-project coding session?

Yes, you can use GitHub issues to validate and start a multi-project coding session. The system parses your provided issue identifier, verifies its existence and open state via the configured tracker adapter, and resolves the correct per-project marker path if the repo is registered.

How do I start an active coding session tied to a specific GitHub issue?

To start an active coding session, run the start command followed by the repository and issue number, such as typing /start-ticket apexyard#41. This validates the GitHub issue, resolves the ops-fork session marker path, and writes the necessary metadata to unblock code editing.

Does ticket validation work with trackers other than GitHub issues?

Yes, ticket validation works with trackers other than GitHub issues. You can configure alternative tracker adapters such as Linear, Jira, Asana, or a custom integration to verify issue existence and state before writing the session marker.

Where are session markers stored for unregistered repositories in a multi-project SDLC?

For unregistered repositories in a multi-project SDLC, session markers are stored in an ops fallback marker located at .claude/session/current-ticket. Registered repos use a per-project marker under .claude/session/tickets/<project>.