update-readme

Generate markdown documentation from conversation history and directory structure.

1|1|Updated May 1, 2025
One-click install
npx skills add https://github.com/jimweller/dotfiles --skill update-readme-jimweller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-readme
Source: https://github.com/jimweller/dotfiles/tree/main/dotfiles/claude-code/skills/update-readme
Command: npx skills add https://github.com/jimweller/dotfiles --skill update-readme-jimweller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of markdown documentation by leveraging conversation history and the contents of a specified directory, streamlining the documentation process.

Core Features & Use Cases

  • Automated Documentation Generation: Writes markdown content based on current conversation and folder structure.
  • Contextual Awareness: Considers sibling and subfolder contents for relevant information.
  • Use Case: After a coding session discussing a new feature, use this Skill to generate an initial draft of the README.md file, incorporating the discussion points and relevant code structure.

Quick Start

Use the update-readme skill to write documentation for the current directory.

Frequently Asked Questions about update-readme

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

FAQPage Schema
How do I generate a README from existing code context?

You can generate a README from code context by applying this Skill to the current directory, where it analyzes conversation history and folder structure to produce structured markdown documentation. It incorporates sibling and subfolder contents into the drafted output.

What is the best way to automate markdown documentation for a new project feature?

Automating markdown documentation for a new project feature is best handled by using conversation context from your coding session. This Skill leverages the discussion points and local directory structure to generate an initial project documentation draft.

Does automated documentation generation work with existing folder structures?

Yes, automated documentation generation works with existing folder structures by reading local directory contents. It processes sibling and subfolder files to extract relevant information to build the generated markdown output.

Can I create knowledge base articles from conversation history?

You can create knowledge base articles from conversation history using this Skill. It processes previous discussion context and local project files to author structured markdown content suitable for knowledge bases.

Do I need to understand markdown syntax to generate project documentation?

You need a basic understanding of markdown syntax and authoring conventions to properly structure the output. The Skill generates the content based on context, but markdown knowledge ensures the final documentation is formatted correctly.

What are the limitations of generating documentation from directory structure?

A limitation of generating documentation from directory structure is that the output relies entirely on the available conversation context and local files. It requires relevant code context to produce a meaningful initial README draft.