skills.rest
nathanvale
nathanvaleCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

plan-expert

Convert planning documents into executable VTM tasks with dependency validation.

Updated Oct 29, 2025
Search Tags:#automation#planning#architecture#task management#specifications#ADR#VTM
One-click install
npx skills add https://github.com/nathanvale/vtm-cli --skill plan-expert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-expert
Source: https://github.com/nathanvale/vtm-cli/tree/main/.claude/skills/plan-expert
Command: npx skills add https://github.com/nathanvale/vtm-cli --skill plan-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander.js, chalk.

What problem does it solve?

This Skill streamlines the complex, often disconnected process of software planning. It automates the conversion of high-level architectural decisions and technical specifications into actionable, executable tasks, eliminating manual task breakdown and ensuring consistency.

Core Features & Use Cases

  • ADR & Spec Creation: Conversationally guides you through creating Architecture Decision Records (ADRs) and detailed technical specifications.
  • Planning Artifact Discovery: Easily list and discover existing ADRs and specs within your project.
  • Plan-to-Task Transformation: Automatically converts planning documents (ADRs, Specs) into executable Virtual Task Manager (VTM) tasks, complete with dependency resolution.
  • Use Case: Imagine you've decided on a new authentication system. Use this Skill to document the decision in an ADR, create a detailed technical specification, and then automatically transform that spec into a set of ready-to-implement VTM tasks, saving hours of manual effort.

Quick Start

Help me plan a new feature for user authentication, starting with an ADR.

Frequently Asked Questions about plan-expert

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

FAQPage Schema
How do I convert planning documents into executable tasks automatically?▼

Plan-expert bridges ADRs and technical specifications into VTM tasks automatically. Document your architectural decisions and specs conversationally, then use the /plan:to-vtm command to transform them into actionable tasks with resolved dependencies, eliminating manual breakdown.

What's the best way to document architecture decisions and create technical specifications?▼

This Skill guides you conversationally through creating Architecture Decision Records (ADRs) and detailed technical specifications. It provides templating support to ensure consistency across your planning artifacts and helps you structure decisions for downstream task generation.

Can I discover and link existing ADRs and specs within my project?▼

Yes. Plan-expert lists and discovers existing planning artifacts—ADRs and specs—already in your project, making it easy to inventory, review, and link related documents before converting them into executable VTM tasks.

How does converting planning documents to tasks save time compared to manual breakdown?▼

Manual task breakdown from specs is error-prone and tedious. Automation handles dependency validation and task structure instantly. A single spec converts into a coordinated set of VTM tasks ready to implement, reducing hours of manual effort and ensuring consistency.

What planning formats does this Skill support for task conversion?▼

Plan-expert works with Architecture Decision Records (ADRs) and technical specifications as input formats. Both are converted into VTM tasks via the plan-to-task transformation with built-in dependency resolution and validation.

Do I need special dependencies or setup to use planning automation?▼

Plan-expert uses commander.js for CLI structure and chalk for output formatting. No additional environment setup is required beyond standard Node.js tooling. The Skill handles ADR/spec templating and VTM task generation internally.

Related Skills

Explore More Software Engineering Skills→
cshyangcshyang

gsd:init-repo

Initialize a GSD repository structure with Git and planning documents.

Community
Intermediate
nathanvalenathanvale

vtm-expert

Identify task-related questions and propose VTM commands for task management.

Community
Intermediate
dev-eloper1dev-eloper1

cl-implementer

Generate and execute implementation tasks from system specifications.

Community
Advanced
mohitmishra786mohitmishra786
159

llvm

Generate, optimize, and inspect LLVM Intermediate Representation using Clang, opt, and llc.

Community
Intermediate