project-standards

project-standards is a skill for Claude Code from jmanhype/speckit. It costs 41 tokens per session (815 once invoked), scanned A, original, MIT.

A project standards guide that explains the coding rules and architectural principles for a repository. It includes test-driven development, or TDD, where tests are written before the code they check.

In plain words
What is it for?
Use it when implementing features, changing code, reviewing compliance, or making architecture decisions.
Why use it?
It keeps implementation and technical decisions aligned with the project's stated rules, including testing, security, and maintainability expectations.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions subagents.

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.

agentmods
npx agentmods add skills/jmanhype/speckit/project-standards
Any agent
npx skills add jmanhype/speckit --skill project-standards
Clone the repo
git clone --depth 1 https://github.com/jmanhype/speckit

Made for: Claude Code.

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-standards

README.md
[![agentmods](https://agentmods.dev/badge/skills/jmanhype/speckit/project-standards.svg)](https://agentmods.dev/skills/jmanhype/speckit/project-standards)
Your own site
<a href="https://agentmods.dev/skills/jmanhype/speckit/project-standards"><img src="https://agentmods.dev/badge/skills/jmanhype/speckit/project-standards.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 815 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00041 $0.00815
Opus 5 $0.00020 $0.00407
Sonnet 5 $0.00008 $0.00163
Haiku 4.5 $0.00004 $0.00081

Measured 4d ago against content hash 43d2bbc5691d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

project-standards 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 4d 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.

.claude/skills/project-standards/SKILL.md · 120 lines

How it starts

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

Project Standards Skill

You are implementing code in a project that follows specific architectural principles and coding standards defined in the project constitution.

When to Invoke This Skill

Claude should use this skill when:

  • Writing or modifying code
  • Making architectural decisions
  • Implementing tasks from tasks.md
  • Reviewing code for compliance
  • Setting up new components or services

How to Use

  1. Read the constitution to understand project principles:

    Read: .specify/memory/constitution.md
    
  2. Apply principles during implementation:

    • TDD: Write tests first, ensure they fail, then implement
    • SOLID: Follow single responsibility, dependency injection
    • Security: No hardcoded secrets, validate all inputs
    • Observability: Add logging, metrics, tracing
  3. Check compliance before marking tasks complete

Key Principles Summary

Test-Driven Development (TDD)

  • Write tests BEFORE implementation code
  • Tests must FAIL initially (Red phase)
  • Implement to make tests pass (Green phase)
  • Refactor after passing (Refactor phase)
  • 100% test pass rate required (enforced by test-gate.sh)

SOLID Architecture

  • Single Responsibility: One reason to change per class/module
  • Open/Closed: Extend via interfaces, don't modify
  • Liskov Substitution: Implementations substitutable for abstractions
  • Interface Segregation: Many focused interfaces
  • Dependency Inversion: Depend on abstractions, inject implementations

Security-First

  • Secrets in environment variables or secret managers only
  • Input validation with strict schemas (Pydantic, Zod)
  • Parameterized queries only (no string interpolation for SQL)
  • Row-Level Security (RLS) for multi-tenant data
  • Rate limiting on all API endpoints

Code Quality

  • Type hints/annotations required
  • Linting must pass (ruff, ESLint)
  • Docstrings for public APIs
  • Meaningful variable/function names

Observability

  • Structured JSON logging with correlation IDs
  • Health check endpoints (/health, /ready, /live)
  • Metrics for critical operations
  • Distributed tracing for cross-service calls

Read the full file on GitHub · 120 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. 4d ago First seen · 120 lines · 41 tokens per session scan A 43d2bbc5691d

Subscribe to this mod's changes

project-standards is a skill published in the GitHub repository jmanhype/speckit (26 stars, last pushed 5mo ago), licensed MIT. It adds 41 tokens to every session and 815 once invoked, about $0.0002 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-09-01.

Related

Other skills, from other repositories

openspec-plus-tdd

MANDATORY skill that activates whenever code is written to implement an OpenSpec change task. Triggers: openspec-plus-apply is active, /opsx-apply is running, the user is implementing tasks from an OpenSpec change, an implementer subagent dispatched by openspec-plus-apply is starting work, or the user invokes phrases…

sudokar/openspec-plus · 190 tokens

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code.

DollarDill/beads-superpowers · 21 tokens

test-driven-development

Use when implementing any feature or bugfix, before writing implementation code.

DollarDill/beads-superpowers · 17 tokens

scaffold-runner

Interactive wrapper for the scaffold CLI that surfaces a pipeline step's decision points before executing it and manages the step lifecycle. Use when the user asks to run a scaffold step ("run scaffold ", "scaffold ", "what's next?"), to start building, or works in a project with a .scaffold/ directory.

zigrivers/scaffold · 73 tokens

work-beads

Work the project's Beads task queue end-to-end - claim a bead, build in an isolated worktree, verify, review, merge, close, report. Use when the user says "/work-beads", "/work-beads 5", "work the next N beads", "work on ", "pick up some open tasks", or asks to work the backlog. Applies to every coding agent (Claude…

zigrivers/scaffold · 106 tokens

scaffold-pipeline

Static reference for scaffold pipeline ordering, dependencies, and phase structure. Use ONLY for questions about pipeline design, step ordering, or dependency constraints — NOT for status, progress, or "what's next" queries (those go through scaffold-runner).

zigrivers/scaffold · 54 tokens