Agent skill

Claude Project Setup

by mohitagw15856 in mohitagw15856/pm-claude-skills

Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost.

MITAuto-check passedAgent Workflows

Install Claude Project Setup

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill claude-project-setup -a claude-code

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

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills claude-project-setup --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/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/claude-project-setup .claude/skills/claude-project-setup && 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
claude-project-setup
GitHub stars
1.4k
Token cost
~1.2k tokens
SKILL.md length
584 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost.

  • Works in 6 steps: Orient fast. Lead with what the project… → Capture the implicit conventions. The… → Give the commands. Build/test/lint/run… → …
  • Asked how do I set up CLAUDE.md
  • SKILL.md covers What This Skill Produces, Required Inputs, Framework: Orient, Constrain,… and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Claude Project Setup is an agent skill from mohitagw15856/pm-claude-skills. Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost. Use when asked how do I set up CLAUDE.md, configure my repo for Claude Code, my AI agent keeps getting my project wrong, or onboard an AI agent to my codebase. Produces a structured CLAUDE.md/project-context file (architecture, conventions, commands, do-nots), the right level of detail (enough to orient, not a novel), the guardrails that…

Its SKILL.md is about 1.2k 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, Creative writing and fiction and LLM guardrails. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked how do I set up CLAUDE.md
  • Configure my repo for Claude Code
  • My AI agent keeps getting my project wrong
  • Onboard an AI agent to my codebase

Example prompts

  • “/claude-project-setup”

Workflow steps

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

  1. Orient fast. Lead with what the project is and its architecture at a glance — the agent needs the map before the details.
  2. Capture the implicit conventions. The rules a human absorbs over months (where files go, naming, preferred patterns) are exactly what an…
  3. Give the commands. Build/test/lint/run commands let the agent verify its own work instead of guessing — this single section prevents most…
  4. Set guardrails. What not to touch, always-run-tests-before-done, and where a human must approve — so autonomy doesn't become damage.
  5. Keep the altitude right. Enough to be useful, short enough to be read — prune anything that doesn't change the agent's behavior.
  6. Maintain it. Update as the project evolves; a stale context file is worse than none because it misleads.

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. 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

Claude Project Setup loads about 1.2k tokens when it runs. Until then it costs about 177 tokens; SKILL.md has 584 words of instructions outside code blocks.

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

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 mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 584 words, ~1,169 tokens.

Download SKILL.mdSave it as .claude/skills/claude-project-setup/SKILL.md (or your agent's skills folder).
name
claude-project-setup
description
Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost. Use when asked how do I set up CLAUDE.md, configure my repo for Claude Code, my AI agent keeps getting my project wrong, or onboard an AI agent to my codebase. Produces a structured CLAUDE.md/project-context file (architecture, conventions, commands, do-nots), the right level of detail (enough to orient, not a novel), the guardrails that keep the agent safe (what not to touch, how to test), and a maintenance habit so it stays current — turning a repo an agent flails in into one it navigates like a teammate.

Claude Project Setup

An AI coding agent is only as good as the context it starts with — drop it into a repo with no orientation and it guesses at your architecture, conventions, and commands. A good CLAUDE.md (or equivalent project-context file) is the onboarding doc that turns flailing into fluency. This builds yours: the architecture and conventions the agent needs, the commands to run, the guardrails on what not to touch, and a habit to keep it current.

What This Skill Produces

  • A structured CLAUDE.md — the sections an agent actually needs: what the project is, architecture/layout, key conventions, the commands (build/test/lint/run), and the do-nots
  • The right altitude — enough to orient the agent fast, not an exhaustive doc it drowns in; signal over completeness
  • Guardrails — what the agent must not touch, how to run tests before claiming done, and where irreversible actions need a human
  • Convention capture — the implicit rules a human learns over months (naming, patterns, where things go) made explicit
  • A commands block — the exact commands to build, test, lint, and run, so the agent verifies its own work
  • A maintenance habit — updating it as the project changes so it doesn't drift into wrong

Required Inputs

Ask for these if not provided:

  • The project — what it is, the stack, rough architecture
  • The conventions — the patterns and rules you'd tell a new hire
  • The commands — how to build, test, lint, run
  • The danger zones — what an agent should never touch or must be careful with
  • Your agent — Claude Code, Cursor, etc. (file name/location may differ)

Framework: Orient, Constrain, Verify, Maintain

  1. Orient fast. Lead with what the project is and its architecture at a glance — the agent needs the map before the details.
  2. Capture the implicit conventions. The rules a human absorbs over months (where files go, naming, preferred patterns) are exactly what an agent can't infer — write them down.
  3. Give the commands. Build/test/lint/run commands let the agent verify its own work instead of guessing — this single section prevents most bad output.
  4. Set guardrails. What not to touch, always-run-tests-before-done, and where a human must approve — so autonomy doesn't become damage.
  5. Keep the altitude right. Enough to be useful, short enough to be read — prune anything that doesn't change the agent's behavior.
  6. Maintain it. Update as the project evolves; a stale context file is worse than none because it misleads.
Show full SKILL.md (190 more words)Show less

Output Format

CLAUDE.md for [project]

What this is: [one-paragraph orientation + architecture at a glance]. Layout: [key directories/modules and what they do]. Conventions: [naming · patterns · where things go · style]. Commands: build: · test: · lint: · run:. Guardrails: [do-not-touch · run tests before done · human-approval zones]. Maintenance: [update when X changes — keep it current].

Quality Checks

  • Orients the agent to purpose and architecture first
  • Makes implicit conventions explicit
  • Includes the exact build/test/lint/run commands
  • Sets guardrails on danger zones and verification
  • Keeps the doc at a readable altitude; sets a maintenance habit

Anti-Patterns

  • A novel the agent won't read, or a stub that orients nothing.
  • Omitting the commands, so the agent can't verify its work.
  • Missing guardrails on irreversible or dangerous actions.
  • Assuming the agent infers conventions it has no way to know.
  • Writing it once and letting it drift out of date.

Example Trigger Phrases

  • "How do I set up a CLAUDE.md for my repo?"
  • "Configure my project so Claude Code works well in it."
  • "My AI agent keeps misunderstanding my codebase — how do I fix that?"
  • "What should go in my project's AI context file?"
  • "Onboard an AI coding agent to my project properly."

© mohitagw15856, 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/claude-project-setup of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Claude Project Setup 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.

Claude Project Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Project Setup this skillmohitagw15856/pm-claude-skills1.4k—~1.2kAutomated safety check: PassMIT
Engineering ConventionsZaxbyHub/opencode-swarm493—~4.7kAutomated safety check: PassMIT
Auto HarnessPacificStudio/openase268—~1.2kAutomated safety check: PassApache-2.0
Story SetupXiaoyangy/novel-studio131—~5.7kAutomated safety check: PassApache-2.0
Openclaw Workspacewin4r/openclaw-workspace288—~2.4kAutomated safety check: PassNone
Clawmemyoloshii/ClawMem210—~7.5kAutomated safety check: PassMIT

Similar skills

  • Engineering Conventions

    ZaxbyHub/opencode-swarm

    Guidelines and non-negotiable engineering invariants for modifying opencode-swarm.

    493 GitHub stars~4.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Auto Harness

    PacificStudio/openase

    Diagnose and strengthen a repository's harness layer: AGENTS.md rules, knowledge layout, architecture boundaries, lint and type gates, API and generated-client contracts, test scaffolding…

    268 GitHub stars~1.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Story Setup

    Xiaoyangy/novel-studio

    网文写作工具集基础设施部署。将 hooks/rules/agents/CLAUDE.md/AGENTS.md 等基础设施部署到用户项目目录,支持 Claude Code / OpenCode / Codex / OpenClaw。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」。

    131 GitHub stars~5.7k tokensUpdated 16 days ago
    Agent WorkflowsAuto-check passed
  • Openclaw Workspace

    win4r/openclaw-workspace

    A skill your agent uses when maintaining or optimizing OpenClaw workspace files — AGENTS.md, TOOLS.md, SOUL.md, USER.md, IDENTITY.md, HEARTBEAT.md, BOOT.md, MEMORY.md, and related checklists and…

    288 GitHub stars~2.4k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed
  • Clawmem

    yoloshii/ClawMem

    ClawMem operational reference for agents at query time — the 3-rule escalation gate, MCP tool routing, the 4 query-optimization levers, pipeline behavior (query vs intentsearch), composite scoring…

    210 GitHub stars~7.5k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • AI Bom

    cdxgen/cdxgen

    Generates AI-BOM, MCP inventory, AI skill inventory, and AI authorship provenance documents with cdxgen, cataloging models, inference services, Hugging Face purls, MCP servers and their…

    1.1k GitHub stars~2.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Claude Project Setup

What does Claude Project Setup do?

Set up a repo or project so an AI coding agent works well in it — the CLAUDE.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost. Claude Project Setup is an agent skill from mohitagw15856/pm-claude-skills.md, the context, the guardrails, and the conventions the agent needs to be useful instead of lost.

When should I use Claude Project Setup?

Claude Project Setup fits situations like: asked how do I set up CLAUDE.md; configure my repo for Claude Code; my AI agent keeps getting my project wrong; onboard an AI agent to my codebase.

How do I install Claude Project Setup in Claude Code?

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

How do I install Claude Project Setup in Codex?

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

Can I use Claude Project Setup 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 mohitagw15856/pm-claude-skills --skill claude-project-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-project-setup, .gemini/skills/claude-project-setup, .github/skills/claude-project-setup and .opencode/skills/claude-project-setup in your project.

What does Claude Project Setup need to run?

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

Does Claude Project Setup 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 Claude Project Setup 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 Claude Project Setup use?

Claude Project Setup 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 Claude Project Setup use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Claude Project Setup?

Skills that share tags, products or a category with Claude Project Setup: Engineering Conventions (ZaxbyHub/opencode-swarm, 493 stars), Auto Harness (PacificStudio/openase, 268 stars), Story Setup (Xiaoyangy/novel-studio, 131 stars) and Openclaw Workspace (win4r/openclaw-workspace, 288 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Project Setup?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.