CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of AI agent skills for Ruby on Rails development. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and workflow automation.

73

Quality

91%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

SKILL.mdticket-planning/

name:
ticket-planning
description:
Drafts, classifies, and optionally creates tickets from an initiative plan. Use when the user provides a plan and wants ticket drafts, wants help shaping a plan into tickets, wants sprint-placement guidance, or wants tickets created in an issue tracker after the plan is approved.

Ticket Planning

Use this skill for initiative-to-ticket workflows:

  • the user already has a plan and wants ticket drafts
  • the user wants help turning an emerging plan into tickets
  • the user wants sprint-placement guidance for those tickets
  • the assistant should create the approved tickets in the issue tracker (when the user has access/tools configured)

This skill covers planning and execution flow, not specific project management tool documentation.

Overview

Normalize inputs, classify each work item, apply title conventions, draft tickets in a standard structure, reduce redundancy, then either return markdown drafts or create issues in the issue tracker after explicit approval.

Workflow

1. Normalize the initiative

Extract planning inputs:

  • initiative/theme
  • project/board
  • whether the request is draft-only or create-in-tracker
  • default sprint or backlog bucket
  • constraints on issue types, prefixes, epic, labels, components, status, or sprint

If the user already has a plan, do not re-plan unless there is a material gap.

2. Classify each ticket before drafting it

Assign these planning attributes to each ticket:

AttributeValues
areabackend | web | mobile | cross-platform | external
typeStory | Task
dependency_levelunblocked | blocked
execution_orderfoundation | api | client | follow-up
coordination_needsingle-team | multi-team
external_dependencyyes | no
urgencynormal | priority
target_bucketready-to-refine | next-dev-sprint | later

Use the classification to decide sequence and sprint placement. Backend/API enablers usually come before dependent web/mobile tickets.

3. Apply title conventions

Use these prefixes:

  • BE | for backend
  • FE | for web / frontend
  • Mobile | for mobile

When writing the ticket title, leave a space after the |.

Do not add those prefixes to tickets that are not owned by those areas unless the user explicitly wants that.

4. Draft tickets in the standard structure

Use this section order:

  1. Summary
  2. Background
  3. Acceptance Criteria
  4. Dependencies
  5. Technical Notes

Write primarily for planning and execution clarity. Keep the main sections business-facing; use Technical Notes only for implementation details that help sequencing or scoping.

5. Reduce redundancy

Do not repeat the same business intent in every section.

Prefer:

  • Summary — core outcome
  • Background — why it exists
  • Acceptance Criteria — observable completion
  • Dependencies — sequencing
  • Technical Notes — fields, systems, identifiers, integration constraints, implementation boundaries

6. Decide whether to stop at drafts or create in the issue tracker

Drafts only:

  • return markdown tickets
  • keep titles, issue types, and dependencies explicit

Create in issue tracker:

  • verify the target project/board details first
  • confirm required fields: project, issue type, sprint, status behavior, epic, labels, components
  • create issues only after the plan is considered approved enough
  • use whatever integration the user has (API, MCP, UI); do not assume credentials in the repo

Sprint Placement Heuristics

Defaults unless the user overrides:

  • foundation or api tickets go before client tickets
  • client tickets depend on stable API behavior when applicable
  • external confirmation tickets usually stay out of active build sprints
  • follow-up tickets can stay in ready-to-refine or later until enabling work is clear

For boards with a named future sprint such as Ready to Refine, treat it as a planning bucket, not an execution guarantee.

Ticket Creation Guidance

When creating tickets in an issue tracker:

  • create them in the project that backs the board
  • do not assume status can be set on create; many workflows use the project's default initial status
  • if sprint assignment is required, inspect create metadata and use the sprint field shape expected by that project
  • validate one issue first if sprint field or workflow behavior is uncertain

Output Patterns

Draft-only output

Provide ticket markdown plus brief sequencing notes when helpful.

Creation output

After creation, report:

  • created issue keys
  • confirmed status
  • confirmed sprint/bucket
  • any assumptions used

Use This Skill When

Typical prompts:

  • "Turn this plan into tickets"
  • "Help me plan the tickets for this initiative"
  • "Draft backend, web, and mobile tickets from this plan"
  • "Which sprint should these tickets go into?"
  • "Create these tickets in our issue tracker once the plan looks right"

Integration

SkillWhen to chain
generate-tasksAfter tasks exist or in parallel — same initiative can feed ticket breakdown
create-prdWhen tickets should align with PRD scope and acceptance themes

ticket-planning

README.md

tile.json