project-conventions

project-conventions is a skill for Claude Code from martian56/claude-engineer. It costs 61 tokens per session (646 once invoked), scanned A, original, MIT.

A project-setup skill for establishing repository conventions and development rules. It covers the folder layout, ignored files, standing agent instructions, documentation, and recommended MCP setup.

In plain words
What is it for?
Use it at the start of a project to create folders such as _private/ and docs/, configure .gitignore, write CLAUDE.md, and start a conventions registry. A monorepo is one repository containing multiple applications, packages, services, or libraries.
Why use it?
It gives a new repository a shared structure and house style before feature work begins. This makes private work, committed documentation, code, and project memory easier to keep separate.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md.

Part of the claude-engineer plugin — 13 skills, 1 command, 2 agents, 3 hooks shipped together

Good fit Use it at the start of a project to create folders such as _private/ and docs/, configure .gitignore, write CLAUDE.md, and start a conventions registry. A monorepo is one repository containing multiple applications, packages, services, or libraries.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/martian56/claude-engineer/project-conventions
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add martian56/claude-engineer --skill project-conventions
Clone the repo
git clone --depth 1 https://github.com/martian56/claude-engineer

Made for: Claude Code.

Or install claude-engineer, the plugin that ships this one along with the rest of its 13 skills, 1 command, 2 agents, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for project-conventions

README.md
[![agentmods](https://agentmods.dev/badge/skills/martian56/claude-engineer/project-conventions.svg)](https://agentmods.dev/skills/martian56/claude-engineer/project-conventions)
Your own site
<a href="https://agentmods.dev/skills/martian56/claude-engineer/project-conventions"><img src="https://agentmods.dev/badge/skills/martian56/claude-engineer/project-conventions.svg" alt="Measured on agentmods" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 646 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.00646
Opus 5 $0.00030 $0.00323
Sonnet 5 $0.00012 $0.00129
Haiku 4.5 $0.00006 $0.00065

Measured 8d ago against content hash 070b08a12aba, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

project-conventions scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/claude-engineer/skills/project-conventions/SKILL.md · 30 lines

How it starts

The opening of the file, as written. The whole thing — 30 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project Conventions

Announce at start: "I'm using claude-engineer:project-conventions to set up the repo's house style."

Folder contract

  • _private/ - UNCOMMITTED working area: drafts, screenshots, scratch notes, research. Add to .gitignore.
  • docs/ - COMMITTED non-code: docs/plan/* (the plan), docs/decisions.md, architecture, runbooks, API docs.
  • .claude-engineer/ - durable state (see claude-engineer:project-memory). Commit memory.md/progress.md; ignore quality-gate-status.json.
  • code - the monorepo (apps/, packages/, services/, libs/; see claude-engineer:monorepo-and-tooling).

Phase 0 setup (create a task per item)

  1. git init (if not a repo). Create .gitignore covering _private/, .claude-engineer/quality-gate-status.json, node_modules, .venv, build dirs, .env*.
  2. Create _private/ and docs/ (with docs/plan/).
  3. Generate a root CLAUDE.md capturing: the stack, the iron laws (plan-gated, CX-first, services-in-docker/app-native, the four quality gates), how to run things, and where state lives. This is the project's standing instruction file.
  4. Initialize the conventions registry at docs/conventions.md - the house style the agent must reuse instead of reinventing: naming, error handling, API response shape, folder patterns, and a UI pattern registry (component + token usage; generalize the design system's DESIGN.md into reusable patterns). Append to it whenever a new pattern is established.
  5. Write docs/recommended-mcps.md from templates/recommended-mcps.md and tell the user which MCPs to install with their own keys.

MCP policy (BYO keys)

Claude-Engineer references MCP servers; it never bundles secrets. Users install with their own keys via each provider's command. See templates/recommended-mcps.md for Playwright, Chrome DevTools, 21st.dev Magic, and designmd (getdesign.md).

Red flags - STOP

  • Committing screenshots/scratch to git → those belong in _private/.
  • Inventing a new pattern that contradicts docs/conventions.md → reuse the house style or update the registry deliberately.
  • Secrets or API keys written into committed files → never; use .env* (git-ignored) and document required vars.

Read the full file on GitHub · 30 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 30 lines · 61 tokens per session scan A 070b08a12aba

Subscribe to this mod's changes

project-conventions is a skill published in the GitHub repository martian56/claude-engineer (2 stars, last pushed 2mo ago), licensed MIT. It adds 61 tokens to every session and 646 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

traction-eos

Implement the Entrepreneurial Operating System (EOS) to align vision and execution across a company. Use when the user mentions "EOS", "Entrepreneurial Operating System", "V/TO", "quarterly rocks", "Level 10 meetings", "accountability chart", "IDS process", "my company feels chaotic", "we keep having the same…

wondelai/skills · 147 tokens

team-topologies

Organize business and technology teams for fast flow using Skelton & Pais's "Team Topologies". Use when the user mentions "team topologies", "Conway's law", "platform team", "stream-aligned team", "team boundaries", "cognitive load", "how should we split teams", "who owns this service", "team dependencies", or…

wondelai/skills · 155 tokens

catchup

Summarize and review what changed while you were away. Use after a weekend, vacation, or flight to check missed PRs, git commits, Linear tickets, and meetings — one prioritized brief, not a firehose.

oliver-kriska/claude-elixir-phoenix · 48 tokens

phx-deps-update

Bump outdated Hex deps — inventory, snapshot changelogs, update, fix breaks, split reviewable PRs (patches bundled, majors solo). Use to upgrade/bump Elixir dependencies or when versions fall behind. NOT for deps.get failures (phx-investigate).

oliver-kriska/claude-elixir-phoenix · 62 tokens

customer-success-management

Runs the ongoing relationship with accounts after the sale — segmenting coverage against account value, building a health score that predicts rather than describes, running reviews customers find worth attending, forecasting renewals honestly, and finding expansion that follows usage instead of quota. Use this to…

cbrock84/headcount · 85 tokens

chief-information-officer

The CIO's remit — running the technology the company works on, service quality, IT spend, and the boundary with product engineering. Use this to set IT priorities, decide what IT owns versus engineering, structure IT spend or an IT roadmap, judge whether to build, buy or outsource, or work out why IT is seen as a cost…

cbrock84/headcount · 79 tokens