superteam-writing-plans

Create structured implementation plans with machine-parseable task blocks

16 stars

Best use case

superteam-writing-plans is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create structured implementation plans with machine-parseable task blocks

Teams using superteam-writing-plans should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/superteam-writing-plans/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/backend/superteam-writing-plans/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/superteam-writing-plans/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How superteam-writing-plans Compares

Feature / Agentsuperteam-writing-plansStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Create structured implementation plans with machine-parseable task blocks

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Writing Plans

## Structure

A good plan has:
1. **Goal** — what are we building and why
2. **Constraints** — technical limitations, dependencies, requirements
3. **Tasks** — ordered, independent, testable units of work
4. **Task block** — machine-parseable task list for automation

## Task Block Format

Include a `superteam-tasks` fenced block for automated task tracking:

````markdown
```superteam-tasks
- title: Create data models
  description: Define TypeScript types and validation for User and Post entities
  files: [src/models/user.ts, src/models/post.ts]
- title: Implement API endpoints
  description: REST endpoints for CRUD operations on User and Post
  files: [src/routes/users.ts, src/routes/posts.ts]
- title: Add authentication middleware
  description: JWT validation middleware for protected routes
  files: [src/middleware/auth.ts]
```
````

### Task Properties
- **title**: Short, action-oriented (verb + noun)
- **description**: What to implement and any key decisions
- **files**: Expected files to create or modify

## Task Guidelines

### Good Tasks
- ✅ "Create user model with email validation" — clear, testable, small
- ✅ "Add JWT authentication middleware" — focused, independent
- ✅ "Implement pagination for list endpoints" — specific feature

### Bad Tasks
- ❌ "Set up the project" — too vague
- ❌ "Implement the entire backend" — too large
- ❌ "Fix bugs" — not specific enough

## Task Ordering

1. Data models and types first (foundation)
2. Core business logic (depends on models)
3. API/UI layer (depends on business logic)
4. Integration and cross-cutting concerns (auth, logging, etc.)
5. Polish and optimization (last)

## Size Guidelines

- **Ideal task**: 1-3 files, 50-200 lines of code + tests
- **Too small**: Renaming a variable (just do it)
- **Too large**: "Implement the auth system" (break into subtasks)
- **Splitting rule**: If you can't describe it in one sentence, split it

Related Skills

ml-paper-writing

16
from diegosouzapw/awesome-omni-skill

Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.

kitt-create-plans

16
from diegosouzapw/awesome-omni-skill

Create hierarchical project plans optimized for solo agentic development. Use when planning projects, phases, or tasks that the AI agent will execute. Produces agent-executable plans with verification criteria, not enterprise documentation. Handles briefs, roadmaps, phase plans, and context handoffs.

airtight-plans

16
from diegosouzapw/awesome-omni-skill

Write structured multi-step implementation plans in markdown format. Plans use numbered steps with clear titles and detailed instructions. Use when asked to create an implementation plan, development roadmap, or multi-step task breakdown.

blog-writing

16
from diegosouzapw/awesome-omni-skill

Write compelling blog posts with proven structure — hook openings, scannable body sections, clear CTAs. Use this skill when drafting blog posts, articles, or content marketing pieces.

writing-skills

16
from diegosouzapw/awesome-omni-skill

Use when creating, updating, or improving agent skills.

writing-project-technical-writing

16
from diegosouzapw/awesome-omni-skill

Writes technical prose (READMEs, ADRs, code comments) in the project's established human voice. Use when creating or editing .md files, writing Swift doc comments, authoring ADRs, or reviewing technical writing for voice consistency.

u09613-writing-and-rhetoric-optimization-for-household-logistics

16
from diegosouzapw/awesome-omni-skill

Operate the "Writing And Rhetoric Optimization for household logistics" capability in production for household logistics workflows. Use when mission execution explicitly requires this capability and outcomes must be reproducible, policy-gated, and handoff-ready.

postmortem-writing

16
from diegosouzapw/awesome-omni-skill

Write effective blameless postmortems with root cause analysis, timelines, and action items. Use when conducting incident reviews, writing postmortem documents, or improving incident response proce...

essay-writing

16
from diegosouzapw/awesome-omni-skill

Writing support (drafting, evaluation and revision) for executives and tech leaders. Support everything from internal culture-building to external technical branding.

copywriting

16
from diegosouzapw/awesome-omni-skill

Write persuasive copy for landing pages, emails, ads, sales pages, and marketing materials. Use when you need to write headlines, CTAs, product descriptions, ad copy, email sequences, or any text meant to drive action. Covers copywriting formulas (AIDA, PAS, FAB), headline writing, emotional triggers, objection handling in copy, and A/B testing. Trigger on "write copy", "copywriting", "landing page copy", "headline", "write a sales page", "ad copy", "email copy", "persuasive writing", "how to write [marketing text]".

Article Writing

16
from diegosouzapw/awesome-omni-skill

Structure and style guidance for law review articles

amazon-writing

16
from diegosouzapw/awesome-omni-skill

Use when writing narrative memos, 6-pagers, 1-pagers, press releases, or PRFAQs in Amazon style. Applies Amazon's no-PowerPoint writing standards with data over adjectives, active voice, and the "so what" test.