How does the Best Practices Extractor find feedback?

The skill uses the GitHub CLI (gh) to fetch inline code review comments from merged pull requests in your specified repository.

What output does this skill produce?

It generates categorized JSON data of comments and structured Markdown documentation located in the .claude/best-practices/ directory.

Can I update my documentation incrementally?

Yes, the skill includes an incremental update script that tracks your last sync timestamp and only fetches comments from new PRs to save time and API quota.

Does this skill work with any repository?

It works with any GitHub repository where you have read access and where the team utilizes inline PR comments for code reviews.

How does this integrate with other agentic skills?

The documentation generated by this skill serves as the reference material for the code-compliance skill, which can then automatically validate new code against these standards.

Best Practices Extractor

Name: Best Practices Extractor
Author: ItamarZand88

byItamarZand88

•

Learning & Documentation

Automates the extraction of coding standards and best practices from pull request comments to create living team documentation.

This skill streamlines the process of building and maintaining project-specific coding standards by analyzing historical pull request feedback. It uses the GitHub CLI to scan PR comments, identifies recurring patterns, and organizes them into categorized markdown documentation within the .claude/best-practices/ directory. By transforming ephemeral review comments into structured guidelines, it enables teams to maintain high code quality, onboard new members faster, and provide a source of truth for automated compliance checking.

Key Features

01Generation of structured markdown documentation with rationales and code examples

02State management to track extraction history and statistics across multiple repositories

03Automated categorization of comments by file tree and directory structure

04Incremental PR scanning to fetch only new feedback since the last update

052 GitHub stars

06Integration with code compliance workflows for automated validation

Use Cases

01Syncing documentation with recent team reviews to keep standards current

02Generating a comprehensive coding standards document for an existing legacy codebase

03Identifying recurring code quality hotspots by analyzing feedback density across the directory tree

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add itamarzand88/claude-code-agentic-engineering best-practices-extractor

For use in Claude.ai and ChatGPT

Download Skill