vapa-proposal

Creates structured project proposals and submits them as GitHub Issues.

1|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/insentek/VAPA --skill vapa-proposal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vapa-proposal
Source: https://github.com/insentek/VAPA/tree/main/skills/vapa-proposal
Command: npx skills add https://github.com/insentek/VAPA --skill vapa-proposal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git, python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the ambiguity of vague project requests by enforcing a structured proposal workflow that ensures every idea is aligned with strategic vision, properly scoped, and reviewed before execution.

Core Features & Use Cases

  • AI-Assisted Drafting: Automatically generates well-structured proposals based on repository context and specific issue types like Features, Problems, or Vision Amendments.
  • Interactive Refinement: Guides users through clarifying questions to ensure proposals are actionable and well-defined.
  • Preview & Confirmation: Provides a full preview of the proposal before submission to GitHub, ensuring quality control.
  • Use Case: A team member has an idea for a new feature; they use this skill to draft a proposal that aligns with the project's VISION.md, ensuring it is ready for team review and eventual implementation.

Quick Start

Use the vapa-proposal skill to draft a new feature proposal by providing a brief subject line describing your idea.

Frequently Asked Questions about vapa-proposal

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

FAQPage Schema
How do I create structured GitHub proposals from rough ideas?

To create structured GitHub proposals, this skill uses repository context and predefined templates to draft feature requests, problem statements, or vision amendments. It interactively refines the idea through clarifying questions before submitting a reviewed issue to GitHub.

Do I need GitHub CLI to submit project proposals to GitHub Issues?

Yes, GitHub CLI is required for authenticated issue management when submitting project proposals. You also need local git repository access so the skill can gather necessary repository context for drafting the structured proposal.

What is the best way to align feature requests with a project's strategic vision?

The best way to align feature requests with strategic vision is using a structured proposal workflow. This skill enforces scoping and alignment by generating drafts based on repository context and predefined templates before team review and execution.

Can I preview a generated proposal before submitting it to GitHub?

Yes, you can preview a generated proposal before submission. The skill provides a full preview of the structured proposal for quality control and requires your confirmation before creating the issue on GitHub.

What types of proposals can I draft using this workflow?

You can draft diverse proposal types including feature requests, problem statements, and strategic vision amendments. The skill uses predefined templates tailored to each specific issue type to ensure the proposal is properly scoped and actionable.

How does AI-assisted drafting work for GitHub Issues?

AI-assisted drafting for GitHub Issues works by integrating local git repository context with predefined templates to automatically generate well-structured proposals. It then guides you through interactive clarifying questions to ensure the output is actionable.