https://github.com/goffity/planner-skills
Universal task planning and breakdown skill for AI coding agents. Auto-detects monorepo vs single-repo. Supports GitHub Issues and Jira.
https://github.com/goffity/planner-skills
agent-skills ai-skills claude-code project-management skills-sh task-planning
Last synced: 2 months ago
JSON representation
Universal task planning and breakdown skill for AI coding agents. Auto-detects monorepo vs single-repo. Supports GitHub Issues and Jira.
- Host: GitHub
- URL: https://github.com/goffity/planner-skills
- Owner: goffity
- License: mit
- Created: 2026-03-12T01:56:30.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-04T15:50:50.000Z (3 months ago)
- Last Synced: 2026-04-04T18:35:04.146Z (3 months ago)
- Topics: agent-skills, ai-skills, claude-code, project-management, skills-sh, task-planning
- Homepage: https://skills.sh
- Size: 106 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Planner Skill
Task planning and breakdown skill for AI coding agents. Analyzes your codebase, breaks work into well-scoped subtasks with dependencies, writes a trackable plan file, and optionally creates GitHub or Jira issues.
## Install
```bash
# Global (all projects)
npx skills add goffity/planner-skill -g
# Project-level
npx skills add goffity/planner-skill
```
## Usage
```
/planner Add user authentication with OAuth2
/planner Refactor database layer to use repository pattern
/planner Fix payment timeout when users checkout with multiple items
/planner
```
## What It Does
1. **Analyzes your codebase** — tech stack, architecture, affected files, test setup
2. **Detects project structure** — auto-detects monorepo vs single-repo
3. **Breaks down tasks** — parent task + subtasks with dependencies, effort estimates, and acceptance criteria
4. **Creates a plan file** — saved to `docs/plans/.md` for tracking
5. **Creates issues** — optionally pushes tasks to GitHub Issues or Jira
## Features
- **Auto monorepo detection** — detects pnpm workspaces, Lerna, Nx, Turborepo, multiple go.mod, etc. Uses `[service]: description` prefix for subtasks in monorepo, plain titles for single-repo
- **Multi-language output** — plan content in English or Thai
- **Dependency tracking** — subtasks ordered by dependencies with execution order
- **Current Flow / New Flow** — parent task always includes before/after behavior description
- **Test subtask** — always includes a test subtask as the last item
- **Two-pass issue creation** — creates all issues first, then links dependencies
## Plan File Example
Plans are saved to `docs/plans/` with this structure:
```markdown
# Plan: Add Authentication Layer
**Status:** approved
**Total Tasks:** 5
**Estimated Effort:** XL
| ID | Title | Type | Priority | Effort | Deps |
|------|--------------------------------|---------|----------|--------|----------|
| T1 | Add authentication layer | feature | high | XL | - |
| T1.1 | Create auth middleware | feature | high | M | - |
| T1.2 | Add JWT token validation | feature | high | M | T1.1 |
| T1.3 | Add login UI components | feature | high | M | T1.2 |
| T1.4 | Unit + Integration tests | test | medium | M | T1.1~T1.3|
```
## Supported Agents
Works with any agent that supports the skills protocol, including:
Claude Code, Cursor, GitHub Copilot, Cline, Windsurf, Roo, and more.
## Supported Issue Trackers
- **GitHub Issues** — via `gh` CLI
- **Jira** — via jira-client script or `/jira` skill
## License
MIT