What format is the output provided in?

The skill returns a curated Markdown table including the specific 'Gotcha', the resulting 'Impact', actionable 'Mitigation' steps, and a link to the 'Source' document.

Can this skill be used outside of creating PRDs?

Absolutely. It is highly effective for manual research when investigating the history of a specific code area or identifying risks associated with a particular library or tool.

Where does the skill look for historical information?

The skill specifically scans the memory/learnings/ directory within your repository for markdown files that follow the flowspec learning format.

How does it determine which learnings are most relevant?

It uses a tiered prioritization strategy: direct file path matches are highest, followed by similar failure modes, shared technology stacks, and finally the recency of the entry.

Historical Learnings & Gotchas

Name: Historical Learnings & Gotchas
Author: jpoley

byjpoley

•

학습 및 문서화

Extracts and curates historical lessons learned from past implementations to prevent recurring mistakes in new requirements and specifications.

The gather-learnings skill acts as an intelligent memory layer for your development workflow by scanning previous implementation failures and 'gotchas' stored within your repository's memory. By performing pattern matching on file paths, technology keywords, and error categories, it automatically generates actionable insights for Product Requirements Documents (PRDs) and Platform Requirements Packages (PRPs). This ensures that critical knowledge gained from past bugs, CI failures, and architectural missteps is proactively applied to new features, significantly reducing technical debt and regression risks.

주요 기능

01Seamless integration with the flowspec documentation methodology

02Pattern-based matching across file paths, keywords, and tags

035 GitHub stars

04Automatic generation of formatted 'Gotchas / Prior Failures' tables

05Contextual analysis of repository-specific learning files

06Intelligent prioritization based on relevance, severity, and recency

사용 사례

01Researching historical context before refactoring legacy code paths

02Identifying technology-specific pitfalls during project design phases

03Populating risk and prior failure sections in new feature PRDs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoley/flowspec gather-learnings

For use in Claude.ai and ChatGPT

Download Skill