ff-project-readme

Generate and validate FassadenFix-compliant README files with Python scripts.

Updated Oct 31, 2025
One-click install
npx skills add https://github.com/FassadenFix/FaFi --skill ff-project-readme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ff-project-readme
Source: https://github.com/FassadenFix/FaFi/tree/main/skills/ff-project-readme
Command: npx skills add https://github.com/FassadenFix/FaFi --skill ff-project-readme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill centralizes the creation and validation of FassadenFix-compliant README files for projects, skills, and internal tools, ensuring brand consistency and CI alignment.

Core Features & Use Cases

  • Template-driven README generation for standard, skill, web, and API formats.
  • Smart content merging to preserve user-provided information while applying FassadenFix branding.
  • CI conformity validation to verify logo usage, colors, badges, and required sections.
  • Use Case: Kick off a new FassadenFix project and generate a ready-to-publish README that matches the corporate design.

Quick Start

Run the generator to create a README by specifying the project name and template type, then optionally save to a file:

  • python scripts/generate_readme.py "<project-name>" --type standard
  • python scripts/generate_readme.py "<project-name>" --type skill --output README.md

Frequently Asked Questions about ff-project-readme

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

FAQPage Schema
How do I generate a README that automatically enforces CI branding and metadata?

To validate CI conformity for README files, the generator checks logo usage, colors, badges, and required sections to ensure your documentation aligns with corporate design standards before publishing.

What is the best way to preserve existing README content while applying a new template?

README templates support standard, skill, web, and API formats, allowing you to generate documentation tailored to various project types while maintaining consistent branding and CI conformance.

Do I need yaml to automate README generation and validation?

Python is required to execute the lightweight generator scripts that merge templates, validate CI conformity, and output publish-ready README files for your projects.

Why does my README fail CI conformity validation after template merging?

To fix README frontmatter metadata errors, ensure your yaml configuration includes all required fields before running the generator script, as the validator enforces strict metadata compliance for CI pipelines.