card-refiner

Generates structured epic and story cards for project boards from rough feature ideas.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/MatheusFelipeCorrea/Agrofarm --skill card-refiner-matheusfelipecorrea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: card-refiner
Source: https://github.com/MatheusFelipeCorrea/Agrofarm/tree/main/.github/skills/card-refiner
Command: npx skills add https://github.com/MatheusFelipeCorrea/Agrofarm --skill card-refiner-matheusfelipecorrea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning rough feature ideas or unstructured requirements into consistent, board-ready cards is slow and error-prone, especially when cards must reference real file paths, existing methods, and correct CREATE/MODIFY indicators. This Skill standardizes that refinement process using the project's own documentation. ## Core Features & Use Cases - Epic Decomposition: Breaks an epic into Story Database, Story Backend, Story Frontend, and Story Prototype cards in dependency order, output as a single README file. - Documentation-Grounded Cards: Reads Architecture Blueprints, exemplars, folder structure docs, and READMEs to mark every file as EXISTENTE — MODIFICAR or NOVO — CRIAR with real paths and exemplar references. - Standardized Templates: Enforces a fixed card format with metadata blocks, user stories, Given/When/Then acceptance criteria, Zod schemas, routes, SQL, and business rules, in Portuguese or English. - Use Case: A tech lead pastes a rough idea for a farm stock-management module; the Skill asks clarifying questions, then produces a README with the Epic plus Database, Backend, Frontend, and Prototype cards referencing the project's actual services, hooks, and endpoints. ## Quick Start Ask the assistant to refine your rough feature idea into structured epic and story cards using the card-refiner skill, providing any project documentation you have.

Frequently Asked Questions about card-refiner

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

FAQPage Schema
How do I turn a rough feature idea into Jira or GitHub Projects cards?

Provide the rough idea and answer the skill's clarifying questions about scope, roles, and operations. It then generates a single README containing the Epic card plus Database, Backend, Frontend, and Prototype story cards ready to copy into your board.

What project documentation does the card refinement process need?

It uses an Architecture Blueprint, exemplars file, folder structure blueprint, project READMEs, and Copilot instructions. These let it reference real file paths, existing methods, and hooks instead of guessing. Without docs, it asks about your stack and flags items for validation.

Can I generate only backend or only frontend story cards?

Yes, the CARD_TYPES configuration lets you request all cards or a custom selection such as Epic only, Backend only, or Frontend only. Consistency is still maintained, so a Backend-only generation includes complete endpoint definitions.

Does the card generator support Portuguese and English output?

Yes, the OUTPUT_LANGUAGE setting controls card content language, supporting pt-BR and English. Technical terms like controller, service, repository, hook, and schema remain in English, and user story phrasing adapts to the selected language.

How does it decide between CREATE and MODIFY for files?

It searches the project documentation for each file. Files found are marked EXISTENTE — MODIFICAR with existing methods listed as unchanged, while missing files are marked NOVO — CRIAR with a full path and an exemplar file to follow.