sruthik27

Creating Claude Md — Development skill for Claude Code

Development community

Claude Code / Codex skill: generate a lean, high-signal CLAUDE.md from scratch via repo scan + focused user interview.

How to install Creating Claude Md

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sruthik27/creating-claude-md and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Creating Claude Md does

Claude Code / Codex skill: generate a lean, high-signal CLAUDE.md from scratch via repo scan + focused user interview.

Alternatives in Development

  • OpenAI Codex CLI — (Rust implementation) 67.8k ★
  • Implementation Plan — You are tasked with creating detailed implementation plans through an interactive, iterative process 10k ★
  • Lean Canvas — Generate Lean Canvas with problem, solution, UVP, and metrics 7.8k ★

README

creating-claude-md

An [Agent Skill](https://www.anthropic.com/news/skills) for generating a lean, high-signal `CLAUDE.md` (or `AGENTS.md`) for a repository from scratch.

Works with Claude Code, Codex, and any other coding agent that supports the SKILL.md format.

What it does

Bootstraps project memory for a repo by combining:

  1. An autonomous repo scan — manifests, structure, linter configs, git history, existing docs, configured MCPs.
  2. A focused 6-question interview — the judgment content only the user can supply (WHY, gotchas, out-of-scope, approval gates, testing philosophy, external docs like Confluence pages).

The output is a `CLAUDE.md` under 80 lines (120 hard cap) where every line earns its place. If a line wouldn't prevent a specific mistake, the skill deletes it.

When to use

  • Repo has no CLAUDE.md and you want one.
  • Existing CLAUDE.md is unsalvageable and you want a clean rewrite.
  • You're setting up a repo for an agent for the first time.

**Not for** auditing or incrementally improving an existing `CLAUDE.md` — that's a separate concern.

Install

Claude Code

Clone into the skills directory:

git clone https://github.com/sruthik27/creating-claude-md.git ~/.claude/skills/creating-claude-md

Then in any repo, ask Claude Code to "create a CLAUDE.md" or "bootstrap project memory" and the skill will trigger.

Codex / other agents

Point your agent at the `SKILL.md` file. The format is plain Markdown with YAML frontmatter — most agent runtimes that support skills accept it as-is.

Key design choices

  • 80-line target, 120 hard cap. Bloat causes harnesses to down-weight every instruction in the file, not just the tail. The cap is a forcing function.
  • Imperative rules, paired with positive alternatives. "Never force-push; rebase locally then push normally" beats "Never force-push" alone.
  • No content that linters already enforce. Indentation, quotes, import order, etc. go in .eslintrc / `bi