write-readme

Generate bufarrow-style READMEs from AGENTS.md, manifest files, and user details.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/loicalleyne/esquisse --skill write-readme-loicalleyne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-readme
Source: https://github.com/loicalleyne/esquisse/tree/main/skills/write-readme
Command: npx skills add https://github.com/loicalleyne/esquisse --skill write-readme-loicalleyne

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation of a README in the bufarrow style, saving developers time and ensuring a consistent, professional appearance for their projects.

Core Features & Use Cases

  • Bufarrow Style: Produces READMEs with a punchy value proposition, use-case table, quick-start patterns, and a curated reference section.
  • Adaptability: Customizes READMEs based on the project's type and language, adapting badges and install sections accordingly.
  • Update Mode: Easily update existing READMEs to align with bufarrow style guidelines.

Quick Start

Run the 'write-readme' skill and follow the prompts to generate your README in bufarrow style.

Frequently Asked Questions about write-readme

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

FAQPage Schema
How do I generate a bufarrow-style README for my project?

To generate a bufarrow-style README, the skill automates initialization, metadata extraction, user interviews, and draft synthesis using your project details and manifest files. It outputs a professional Markdown document with a punchy value proposition and curated reference section.

What is the bufarrow style for project documentation?

The bufarrow style is a specific README format featuring a punchy value proposition, a use-case table, quick-start patterns, and a curated reference section. It ensures a consistent, professional appearance for project documentation across different languages.

Do I need an AGENTS.md file to create markdown READMEs with this tool?

Yes, creating markdown READMEs with this tool requires input from an AGENTS.md file, manifest files, and user-provided details. These inputs drive the metadata extraction and draft synthesis processes to ensure accurate project documentation.

Can I update an existing README to match the bufarrow style?

Yes, you can update existing READMEs to align with bufarrow style guidelines using the tool's update mode. It adapts your current project documentation to include the required use-case table, quick-start patterns, and curated reference section.

How does the README generator handle different project types and languages?

The README generator customizes its output by adapting badges and install sections based on the specific project type and language. This ensures the generated markdown documentation remains relevant and accurate for your particular development environment.