propose-spec

Generate proposed specification documents from project context and open a pull request.

1|Updated Jul 5, 2026
One-click install
npx skills add https://github.com/stoodder/materia --skill propose-spec-stoodder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propose-spec
Source: https://github.com/stoodder/materia/tree/main/plugins/materia/skills/propose-spec
Command: npx skills add https://github.com/stoodder/materia --skill propose-spec-stoodder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the process of converting user ideas into structured, proposed-spec files that adhere to project standards, reducing manual input and streamlining collaboration.

Core Features & Use Cases

  • Automated Drafting: Creates a complete proposal draft with default values based on project context.
  • Interactive Adjustment: Allows users to confirm or adjust the draft directly.
  • Efficient Feedback Loop: Enables the integration of feedback before finalizing the proposal.

Quick Start

Enter your idea using the command: /materia:propose-spec <your idea> and follow the prompts to generate your proposed spec.

Frequently Asked Questions about propose-spec

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

FAQPage Schema
How do I generate a project specification from a raw idea?

Generating a project specification from a raw idea involves submitting your concept via a command interface to produce a structured draft. The tool validates identifiers against your codebase and allows interactive adjustments before opening a pull request.

What is the best way to convert project enhancement ideas into proposed spec files?

Converting project enhancement ideas into proposed spec files is best handled by a specification generation tool that integrates with your codebase to validate identifiers. This approach reduces manual input and streamlines team collaboration through structured draft creation.

How do I create a specification draft that adheres to existing project standards?

Creating a specification draft that adheres to existing project standards requires a tool that reads project context like CLAUDE.md and existing documentation. The automated drafting process uses these files to populate default values and validate identifiers against the live codebase.

Can I adjust a generated specification draft before finalizing it?

Yes, you can adjust a generated specification draft before finalizing it through an interactive feedback loop. The tool allows you to confirm or modify the draft directly, enabling the integration of feedback before opening a pull request on the proposal.

Does specification generation work with existing project documentation and codebase integration?

Specification generation works with existing project documentation and codebase integration by reading context files like CLAUDE.md and .materia/docs/. It validates identifiers against the live codebase to ensure the proposed specification aligns with current project standards.

Why does my specification proposal need identifier validation against the codebase?

Your specification proposal needs identifier validation against the codebase to ensure the drafted changes align with existing project components and naming conventions. This prevents integration errors and maintains consistency across the proposed specification and the live codebase.