About

Imported from akillness/jeo-skills (.agent-skills/to-issues/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill to-issues. Copyright stays with the author.

To Issues

Name: to-issues
Author: akillness

Convert plans and specs into independently-actionable vertical slice issues.

When to use this skill

Breaking down a plan or PRD into implementation tickets
Decomposing a feature into parallel work items
Preparing work for AI agents (AFK) or human developers (HITL)

When not to use this skill

Creating a PRD from scratch → use to-prd
Evaluating/categorizing existing issues → use triage
Planning without implementation tickets → use task-planning

Core principle: vertical slices

Each slice is a narrow but COMPLETE path through every layer: schema, API, UI, tests. Completed slices are independently demoable.

❌ Horizontal: "Add all database tables" → "Add all API endpoints" → "Add all UI components" ✅ Vertical: "User can create a task" (schema + API + UI + tests, end-to-end)

Issue types

HITL — requires human interaction: architectural decisions, design review, external access, manual testing
AFK — implementable and mergeable without human input (preferred when possible)

Process

1. Gather context

Read the plan from the conversation or fetch referenced issues. Understand the full scope before decomposing.

2. Explore the codebase

Use the project's domain glossary (CONTEXT.md) and vocabulary when naming issues. Understand current state to avoid redundant work.

3. Draft vertical slices

Each slice = one independently-completable unit of user-facing value
Each slice cuts through all relevant layers
Order by dependency (what must exist before what)
Label HITL or AFK

4. Quiz the user

Before publishing, confirm:

Are the slices the right granularity? (Too big = hard to estimate; too small = churn)
Are dependencies correctly ordered?
Any slices that should be merged or split?
Any HITL/AFK classifications to change?

5. Publish to tracker

Publish in dependency order. Use the standard issue template:

## Context

[Brief description of what this slice delivers and why it matters]

## Acceptance Criteria

- [ ] [Specific, testable criterion]
- [ ] [Specific, testable criterion]

## Implementation Notes

[Key decisions, constraints, or approach hints if known]

## Type

HITL | AFK

Add appropriate labels: category (bug/enhancement) + state (needs-triage or ready-for-agent/ready-for-human).

Instructions

Identify the task trigger and expected output.
Follow the workflow steps in this skill from top to bottom.
Validate outputs before moving to the next step.
Capture blockers and fallback path if any step fails.

Examples

Example: Apply this skill to a small scope first, then scale to full scope after validation passes.

Best practices

Keep outputs deterministic and auditable.
Prefer small reversible changes over broad risky edits.
Record assumptions explicitly.

References

Project standards: .agent-skills/skill-standardization/SKILL.md
Validator script: .agent-skills/skill-standardization/scripts/validate_skill.sh

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-to-issues/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-to-issues.ocm.jsonjson

{
  "ocm": "1",
  "id": "akillness-jeo-skills-to-issues",
  "kind": "skill",
  "name": "to-issues",
  "description": "Convert plans/specs into independently-grabbable vertical slice issues (HITL or AFK classification)",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "issues",
      "planning",
      "vertical-slices",
      "decomposition",
      "project-management",
      "tickets",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Convert plans/specs into independently-grabbable vertical slice issues (HITL or AFK classification)"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/to-issues/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/to-issues/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/to-issues/SKILL.md"
    },
    "compatibility": "Works with GitHub Issues, Linear, or any issue tracker. Run setup-matt-pocock-skills first to configure tracker location and label vocabulary. Pairs with to-prd for requirements and triage for issue s",
    "allowed_tools": [
      "Read",
      "Grep",
      "Glob",
      "Bash",
      "Write",
      "Edit"
    ]
  },
  "instructions": "# To Issues\n\nConvert plans and specs into independently-actionable vertical slice issues.\n\n## When to use this skill\n\n- Breaking down a plan or PRD into implementation tickets\n- Decomposing a feature into parallel work items\n- Preparing work for AI agents (AFK) or human developers (HITL)\n\n## When not to use this skill\n\n- Creating a PRD from scratch → use `to-prd`\n- Evaluating/categorizing existing issues → use `triage`\n- Planning without implementation tickets → use `task-planning`\n\n## Core principle: vertical slices\n\nEach slice is a **narrow but COMPLETE path through every layer**: schema, AP",
  "cost": {
    "context_tokens": 755
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-to-issues/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.