Agent skill

Setup Claude Md

by ambient-code in ambient-code/agentready

Create comprehensive CLAUDE.md files with tech stack, standard commands, repository structure, and boundaries to optimize repositories for AI-assisted development

MITAuto-check passedAgent Workflows

Install Setup Claude Md

skills CLI
$ npx skills add ambient-code/agentready --skill setup-claude-md -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ambient-code/agentready setup-claude-md --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ambient-code/agentready.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.skills-proposals/setup-claude-md .claude/skills/setup-claude-md && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup-claude-md
GitHub stars
154
Token cost
~236 tokens
SKILL.md length
81 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Create comprehensive CLAUDE.md files with tech stack, standard commands, repository structure, and boundaries to optimize repositories for AI-assisted development

  • Works in 3 steps: Review the pattern summary above → Apply the pattern to your repository → Verify the implementation matches the…
  • Tasks that involve Agent instruction files
  • SKILL.md covers When to Use This Skill, Instructions, Examples and Best Practices, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Setup Claude Md is an agent skill from ambient-code/agentready. Create comprehensive CLAUDE.md files with tech stack, standard commands, repository structure, and boundaries to optimize repositories for AI-assisted development

Its SKILL.md is about 240 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent instruction files and Proposals and quotes. It works with Python. The repository describes itself as: Repo Optimizer: Assess git repositories for AI-assisted development readiness. Submit your score! The licence is MIT.

When your agent uses it

  • Tasks that involve Agent instruction files
  • Tasks that involve Proposals and quotes

Example prompts

  • “/setup-claude-md”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Review the pattern summary above
  2. Apply the pattern to your repository
  3. Verify the implementation matches the examples below

What it can do on your machine

Read from SKILL.md and the folder at commit a2268d6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup Claude Md loads about 236 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 81 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~236

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ambient-code/agentready at commit a2268d6, republished under its MIT licence (© ambient-code). 81 words, ~236 tokens.

Download SKILL.mdSave it as .claude/skills/setup-claude-md/SKILL.md (or your agent's skills folder).
name
setup-claude-md
description
Create comprehensive CLAUDE.md files with tech stack, standard commands, repository structure, and boundaries to optimize repositories for AI-assisted development

Setup CLAUDE.md Configuration

When to Use This Skill

Project-specific configuration for Claude Code

Instructions

  1. Review the pattern summary above
  2. Apply the pattern to your repository
  3. Verify the implementation matches the examples below

Examples

Example 1
CLAUDE.md found at /Users/jeder/repos/agentready/CLAUDE.md

Best Practices

  • Follow the pattern consistently across your codebase
  • Refer to the citations below for authoritative guidance
  • Test the implementation after applying the pattern

Citations

No citations available


Generated by: AgentReady Skill Generator Confidence: 100.0% Source Attribute: claude_md_file Reusability: 100.0% Impact: +50.0 pts

© ambient-code, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .skills-proposals/setup-claude-md of ambient-code/agentready.

Open the folder on GitHubat commit a2268d6

Compare with similar skills

Setup Claude Md next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup Claude Md compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup Claude Md this skillambient-code/agentready154—~236Automated safety check: PassMIT
Mspm0 Ccsmc3545dada/mspm0-skill374—~4.5kAutomated safety check: PassMIT
Generate AI Rulesdivar-ir/ai-doc-gen766—~1.2kAutomated safety check: PassMIT
Goal Prompt Builderwin4r/goal-prompt-builder229—~3.1kAutomated safety check: PassMIT
Requirement Ledger CLI Workflowadand-91/gpt-6-astra-skill125—~1.5kAutomated safety check: PassMIT
Analyze Codebasedivar-ir/ai-doc-gen766—~899Automated safety check: PassMIT

Similar skills

  • Mspm0 Ccs

    mc3545dada/mspm0-skill

    Tool-neutral CLI agent rules for TI MSPM0 development with Code Composer Studio, Keil/uVision, CMake/GCC/OpenOCD, SysConfig, and DriverLib.

    374 GitHub stars~4.5k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Generate AI Rules

    divar-ir/ai-doc-gen

    Generate AI assistant configuration files for a repository — CLAUDE.md, AGENTS.md, and Cursor rules (.cursor/rules/.mdc) — from codebase analysis.

    766 GitHub stars~1.2k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Goal Prompt Builder

    win4r/goal-prompt-builder

    Build high-quality /goal commands for OpenAI Codex CLI 0.128+ that maximize audit-friendliness and minimize false-completion.

    229 GitHub stars~3.1k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Requirement Ledger CLI Workflow

    adand-91/gpt-6-astra-skill

    Runs an evidence-bound audit, daily or weekly review through the requirement-ledger CLI, binding scope and authority first and blocking the final report until a handoff check passes.

    125 GitHub stars~1.5k tokensUpdated 22 days ago
    Agent WorkflowsAuto-check passed
  • Analyze Codebase

    divar-ir/ai-doc-gen

    Run a multi-agent deep analysis of a codebase, producing AI-readable analysis documents in .ai/docs/ covering structure, dependencies, data flow, request flow, and APIs.

    766 GitHub stars~899 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Agent WorkflowsAuto-check passed

More from ambient-code/agentready

  • Implement Type Annotations

    ambient-code/agentready

    Add comprehensive type hints to Python/TypeScript code to improve IDE support, catch errors early, and enable better AI code understanding

    154 GitHub stars~231 tokensUpdated 7 days ago
    Auto-check passed

Works with

Categories

Questions about Setup Claude Md

What does Setup Claude Md do?

Create comprehensive CLAUDE.md files with tech stack, standard commands, repository structure, and boundaries to optimize repositories for AI-assisted development. Setup Claude Md is an agent skill from ambient-code/agentready.

When should I use Setup Claude Md?

Setup Claude Md fits situations like: tasks that involve Agent instruction files; tasks that involve Proposals and quotes.

How do I install Setup Claude Md in Claude Code?

Run `npx skills add ambient-code/agentready --skill setup-claude-md -a claude-code`. Or copy the skill folder (.skills-proposals/setup-claude-md in ambient-code/agentready) into .claude/skills/setup-claude-md in your project. Claude Code loads it when a task matches its description.

How do I install Setup Claude Md in Codex?

Run `npx skills add ambient-code/agentready --skill setup-claude-md -a codex`. Or copy the skill folder (.skills-proposals/setup-claude-md in ambient-code/agentready) into .agents/skills/setup-claude-md in your project. Codex loads it when a task matches its description.

Can I use Setup Claude Md in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ambient-code/agentready --skill setup-claude-md -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-claude-md, .gemini/skills/setup-claude-md, .github/skills/setup-claude-md and .opencode/skills/setup-claude-md in your project.

What does Setup Claude Md need to run?

SKILL.md names no scripts, command-line tools or credentials: Setup Claude Md is instructions for the agent only.

Does Setup Claude Md access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Setup Claude Md safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup Claude Md use?

Setup Claude Md is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup Claude Md use?

About 236 tokens (SKILL.md is roughly 944 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup Claude Md?

Skills that share tags, products or a category with Setup Claude Md: Mspm0 Ccs (mc3545dada/mspm0-skill, 374 stars), Generate AI Rules (divar-ir/ai-doc-gen, 766 stars), Goal Prompt Builder (win4r/goal-prompt-builder, 229 stars) and Requirement Ledger CLI Workflow (adand-91/gpt-6-astra-skill, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Claude Md?

ambient-code (a GitHub organization) maintains it in ambient-code/agentready, which has 154 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 1, 2026.

Source: ambient-code/agentready on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.