oh-plan

Convert grounding context into 1–4 GitHub issues with acceptance criteria.

3|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/open-horizon-labs/bottle --skill oh-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oh-plan
Source: https://github.com/open-horizon-labs/bottle/tree/main/.claude-plugin/plugins/miranda/skills/oh-plan
Command: npx skills add https://github.com/open-horizon-labs/bottle --skill oh-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts grounding context from the skills workflow into actionable GitHub issues, enabling fast planning and execution.

Core Features & Use Cases

  • Transforms grounding insights into issue tickets with goals and acceptance criteria.
  • Supports session-mode and task-mode workflows to generate context-rich tasks.
  • Produces 1–4 well-scoped issues with explicit dependencies and references for handoff.

Quick Start

Ground the context with /aim, /problem-space, and /solution-space, then run /oh-plan <session> to generate issues. Use /oh-task to work the created issues and track progress.

Frequently Asked Questions about oh-plan

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

FAQPage Schema
How do I convert context into actionable GitHub issues for project planning?

To convert context into actionable GitHub issues, use the oh-plan skill to generate 1-4 well-scoped tickets with clear goals, acceptance criteria, and explicit dependencies from your session context. This enables fast planning and rapid handoff for execution.

What is the best way to automate issue decomposition from a planning session?

The best way to automate issue decomposition is to ground your context first, then run the planning workflow to generate well-scoped GitHub issues. This process transforms grounding insights into 1-4 structured tickets with explicit dependencies and references for handoff.

How do I generate GitHub issues with acceptance criteria from session context?

You generate GitHub issues with acceptance criteria by applying the planning skill to your session context. It transforms grounding insights into structured outputs, ensuring each issue features clear goals, dependencies, and optional references for execution.

Can I use this issue generation workflow in both session-mode and task-mode?

Yes, you can use this issue generation workflow in both session-mode and task-mode. The skill supports both operational modes to produce context-rich, well-scoped GitHub issues with explicit dependencies for rapid handoff to task execution.

Do I need to ground context before generating GitHub issues for workflow automation?

Yes, you need to ground context before generating GitHub issues for workflow automation. You must first gather context using grounding commands, then run the planning skill to convert those grounding insights into well-scoped issues with acceptance criteria.

What are the limitations of generating GitHub issues from session context?

A limitation of generating GitHub issues from session context is that the skill produces a maximum of 1-4 well-scoped issues per run. It requires prior grounding context and is specifically designed for the Open Horizons skills workflow rather than standalone use.