agent-md-writing

Name: agent-md-writing
Availability: InStock
Author: kaptinlin

Generate CLAUDE.md and AGENTS.md guidelines from repository structure and docs.

23|2|Updated Jun 9, 2025

Search Tags:#documentation #spec-driven #claude-md #md-generation #agents-md #ai-guidelines #go-projects

Ready to run

npx skills add https://github.com/kaptinlin/gozod --skill agent-md-writing

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-md-writing
Source: https://github.com/kaptinlin/gozod/tree/main/.agents/skills/agent-md-writing
Command: npx skills add https://github.com/kaptinlin/gozod --skill agent-md-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate CLAUDE.md and AGENTS.md guidelines by analyzing repository structure and existing docs to establish consistent AI agent development standards.

Core Features & Use Cases

Generates CLAUDE.md and AGENTS.md templates tailored to the project's SPECS/references structure.
Produces an Agent Workflow section when SPECS/References exist.
Provides a Skills Index linking to .claude/skills/ and .agents/skills/ for AI agents.

Quick Start

Create CLAUDE.md at the repository root and symlink AGENTS.md to CLAUDE.md, applying the project's existing conventions.

Frequently Asked Questions about agent-md-writing

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

FAQPage Schema

How do I auto-generate CLAUDE.md and AGENTS.md guidelines for a Go project?▼

Auto-generate CLAUDE.md and AGENTS.md guidelines by analyzing the repository structure and existing docs. The tool reads SPECS/ and .references/ directories to produce a developer-facing CLAUDE.md that codifies design principles and an Agent Workflow.

What is a CLAUDE.md file used for in AI agent development?▼

A CLAUDE.md file is used to establish AI agent development standards by codifying design philosophy, coding rules, and agent skills indexing. It acts as a developer-facing template that guides AI agents working within the repository.

Does CLAUDE.md generation require SPECS/ and .references/ directories?▼

CLAUDE.md generation is designed for Go projects with SPECS/ and .references/ directories. When these directories exist, the generation process includes an Agent Workflow section and links to .claude/skills/ and .agents/skills/.

How do I link AGENTS.md to CLAUDE.md using a symlink?▼

To link AGENTS.md to CLAUDE.md, create CLAUDE.md at the repository root and symlink AGENTS.md to CLAUDE.md. This applies the project's existing conventions and ensures both files share the same generated AI guidelines.

What's the best way to structure AI agent coding rules in a repository?▼

The best way to structure AI agent coding rules is to use a structured CLAUDE.md template that includes a Design Philosophy section, Coding Rules, and an Agent Skills index linking to .claude/skills/ and .agents/skills/ directories.

Can I use this CLAUDE.md template for non-Go projects without SPECS?▼

This CLAUDE.md template is specifically applicable to Go projects with SPECS/ and .references/ directories. Projects without this structure may not generate the Agent Workflow section or properly index the agent skills.