skills.rest
kaptinlin
kaptinlinCOMMUNITY
Explore all skills by this author →
GitHub

agent-md-writing

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
One-click install
npx skills add https://github.com/kaptinlin/gozod --skill agent-md-writing
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
Reading-Advantage-ThailandReading-Advantage-Thailand

project-init

Scaffold project directories for spec-driven development workflows.

Official
Basic
aspiersaspiers
15

project-initialization

A single-page web app that lets users create, store, and share collections of recipesUTEKSTILGODNINGSTEGN.

Community
Intermediate
johan--johan--

create-specs

Convert reverse-engineering documentation into GitHub Spec Kit format.

Community
Advanced
anton-abyzovanton-abyzov
43

agents-md-author

Generates AGENTS.md and CLAE.md files from a project's codebase and its README documentation.

Community
Advanced