Claude MarketplacesSubmit
pproenca avatar

Feature Spec

pproenca/dot-skills

A comprehensive framework for writing specs that don't turn into scope nightmares. You get 42 rules across 8 categories, from critical scope definition and requirements clarity down to documentation standards. The prioritization is smart: it pushes you to nail boundaries and acceptance criteria first before worrying about formatting. Uses practical frameworks like MoSCoW, RICE scoring, and Given-When-Then for acceptance criteria. The rule prefixes make it easy to reference specific guidelines. Best used when you're writing PRDs, managing stakeholder expectations, or trying to prevent the inevitable "just one more thing" requests from derailing your timeline.

skills.sh installs
431
GitHub stars
222
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill feature-spec --agent claude-code

Installs into .claude/skills of the current project.

Files

Software Engineering Feature Specification and Planning Best Practices

Comprehensive feature specification and planning guide for software engineers, product managers, and technical leads. Contains 42 rules across 8 categories, prioritized by impact to prevent scope creep and ensure project success.

When to Apply

Reference these guidelines when:

  • Writing PRDs or feature specifications
  • Defining requirements or user stories
  • Managing scope and preventing scope creep
  • Prioritizing features and backlog items
  • Handling change requests
  • Aligning stakeholders on project goals

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Scope DefinitionCRITICALscope-
2Requirements ClarityCRITICALreq-
3Prioritization FrameworksHIGHprio-
4Acceptance CriteriaHIGHaccept-
5Stakeholder AlignmentMEDIUM-HIGHstake-
6Technical SpecificationMEDIUMtech-
7Change ManagementMEDIUMchange-
8Documentation StandardsLOWdoc-

Quick Reference

1. Scope Definition (CRITICAL)

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/pproenca/dot-skills
Categories
Documentation, Productivity & Planning
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100

Recommended

More Documentation
1rysweet avatarmermaid-diagram-generatorrysweet/amplihackConverts architecture descriptions, module specs, or workflow docs into Mermaid diagrams. Use when visualizing brick module relationships, workflows (DDD, inves429skills.sh installs
2tldraw avatarwrite-prtldraw/tldrawReference standards for writing pull request titles and descriptions in the tldraw repository, plus the pre-flight comment sweep over the diff. Use as supportin424skills.sh installs
3owainlewis avatarspecowainlewis/blueprintWrite a short implementation spec at docs/<feature-slug>/spec.md and pause for review. Use when behavior, interfaces, data, or errors need decisions before codi423skills.sh installs
4syncfusion avatarsyncfusion-blazor-dropdownssyncfusion/blazor-ui-components-skillsComprehensive guide for implementing Syncfusion Blazor dropdown components including AutoComplete, ComboBox, DropDown List, MultiSelect Dropdown, and ListBox. U418skills.sh installs
5umbraco avatarumbraco-dashboardumbraco/umbraco-cms-backoffice-skillsImplement dashboards in Umbraco backoffice using official docs418skills.sh installs
6pproenca avatartddpproenca/dot-skillsTest-Driven Development methodology and red-green-refactor workflow (formerly test-tdd). This skill should be used when practicing TDD, writing tests first, des415skills.sh installs