How many core capabilities should a project have?

For optimal feature generation, it is recommended to define between 8 and 15 capabilities to avoid features that are either too broad or too fragmented.

What schema does the spec optimizer follow?

It follows the SpecOutput interface, which requires fields like project_name, overview, technology_stack, core_capabilities, and implemented_features.

How does this skill improve feature generation quality?

By using precise language, specific file paths, and proper capability ordering, it provides the AI with clearer constraints and context, resulting in more accurate feature output.

Does it support existing codebases?

Yes, the skill can help synchronize existing codebase structures into the specification, including identifying the technology stack and documenting implemented features.

What is the difference between app_spec.txt and spec.md?

app_spec.txt is a structured XML file used by Automaker's backend for feature generation, while spec.md is a human-readable Markdown file for supplementary documentation.

Automaker Spec Optimizer

Name: Automaker Spec Optimizer
Author: jbactad

byjbactad

0•

生産性とワークフロー

Optimizes project specifications to improve the quality of AI-generated features and autonomous development workflows.

This skill focuses on refining project specifications within the Automaker ecosystem, ensuring that app_spec.txt and spec.md files are structured for maximum AI comprehension. It provides guidance on maintaining a structured 'source of truth' by optimizing technology stacks, core capabilities, and implementation roadmaps. By aligning specifications with the SpecOutput schema, the skill ensures that subsequent feature generation is context-aware, technically accurate, and logically sequenced for autonomous development cycles.

主な機能

01Optimizes app_spec.txt XML and spec.md Markdown for AI clarity

02Maps core capabilities to logical, implementable feature sets

03Implements codebase anchoring by referencing specific file paths and patterns

04Automates technology stack identification and version documentation

050 GitHub stars

06Synchronizes implemented features and roadmap statuses from the codebase

ユースケース

01Updating project specs after significant codebase changes to maintain AI alignment

02Restructuring a vague project overview into a precise, feature-ready specification

03Optimizing feature generation quality for large-scale autonomous development projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jbactad/claude-plugins spec-optimizer

For use in Claude.ai and ChatGPT

主な機能

01Optimizes app_spec.txt XML and spec.md Markdown for AI clarity

02Maps core capabilities to logical, implementable feature sets

03Implements codebase anchoring by referencing specific file paths and patterns

04Automates technology stack identification and version documentation

050 GitHub stars

06Synchronizes implemented features and roadmap statuses from the codebase

ユースケース

01Updating project specs after significant codebase changes to maintain AI alignment

02Restructuring a vague project overview into a precise, feature-ready specification

03Optimizing feature generation quality for large-scale autonomous development projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jbactad/claude-plugins spec-optimizer

For use in Claude.ai and ChatGPT