proposal

Draft and validate design proposals for Skaile features and architectural changes.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/skaile-ai/ai-assets --skill proposal-skaile-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: proposal
Source: https://github.com/skaile-ai/ai-assets/tree/main/skaile-development/skills/proposal
Command: npx skills add https://github.com/skaile-ai/ai-assets --skill proposal-skaile-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams capture, structure, and socialize design proposals for new features, architectural changes, or cross-package work, preventing vague requests and speeding up approvals.

Core Features & Use Cases

  • Structured frontmatter-driven proposals ensure consistent metadata (author, date, status, scope, type) and traceability.
  • Guided workflows for create/review/update capture the problem, alternatives, trade-offs, and decisions to move from concept to approval.
  • Outputs and traceability generate design docs to docs/superpowers/specs and keep devlog records linking proposals to implementation work.

Quick Start

Create a new proposal by selecting a topic, mode (create, review, update), and affected packages, then draft the design spec.

Frequently Asked Questions about proposal

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

FAQPage Schema
How do I draft a design proposal for architectural changes?▼

Draft an architectural design proposal by selecting a topic, mode (create, review, update), and affected packages to generate a structured spec capturing problem statements, alternatives, and approval status.

What is a structured design proposal and when do I need one?▼

A structured design proposal captures problem statements, alternatives, trade-offs, and decisions for cross-package work. You need one to prevent vague requests and speed up team approvals for new features.

Can I use this to review and update existing design specs?▼

Yes, you can review and update existing design specs using guided workflows that capture changes to problem statements, alternatives, and decisions, then output updated specification documents and devlog entries.

Does this skill enforce frontmatter metadata for design documentation?▼

Yes, it enforces strict frontmatter requirements including author, date, status, scope, and type to ensure consistent metadata and traceability across all design documentation and devlog records.

What's the best way to trace approved design proposals to implementation work?▼

Trace approved design proposals to implementation work by generating specification docs to structured locations and maintaining linked devlog records that capture the problem, alternatives, and final decisions.

How do design proposals generated here compare to ad-hoc documentation?▼

Unlike ad-hoc documentation, these design proposals use frontmatter-driven structure and guided workflows to enforce consistent metadata, capture trade-offs explicitly, and output traceable spec and devlog records.