linting_formating SKILL.md skillB

linting_formating from nerds-odd-e/doughnut is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nerds-odd-e/doughnut/linting_formating@git:20261101.b373ef6

Pins git:20261101.b373ef6 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
nerds-odd-e/doughnut
Path
.agents/skills/linting_formating/SKILL.md
Versions recorded
9
Latest version
git:20261101.b373ef6, committed Nov 1, 2026
First version recorded
Sep 16, 2026
Size
12,178 bytes
Repository stars
50
License
MIT

Linting, formatting, code quality, Biome (2.6.x), Redocly, OpenAPI validation, code style, fix formatting errors, biome.json config, Vue SFC project-domain rule limitation, multi-file analysis (MFA). Use when linting, formatting, Biome, or OpenAPI validation.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Linting and Formatting in Donut Project

## When to Use This Rule

**Use this rule when:**
- Fixing linting or formatting errors
- Running code quality checks
- Validating OpenAPI specifications
- Formatting code before committing
- Troubleshooting linting failures
- Working with Biome, Redocly, or backend linting

## Overview

This project uses multiple linting tools to ensure code quality:
- **Biome**: Frontend, CLI, `packages/donut-test-fixtures`, Cypress, and other root-level TypeScript/JavaScript code
- **Redocly CLI**: OpenAPI specification validation
- **Backend linting**: Java code quality checks (via Gradle)

## Linting Philosophy

**IMPORTANT**: Linting is primarily for CI/CD validation. During development,
format changed components explicitly before staging; the pre-commit hook only
validates staged components and never formats or stages files.

## Running Linting

Run commands from the repo root through Nix.

### Lint All Code

```bash
CURSOR_DEV=true nix develop -c pnpm lint:all
```

This runs:
- Backend Java linting (`pnpm backend:lint`)
- Frontend TypeScript/Vue linting (`pnpm frontend:lint`)
- CLI TypeScript linting (`pnpm cli:lint`)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nerds-odd-e/doughnut/linting_formating@sha256:1fc07fdcfef4cc1e

The line at the top of this page pins the label git:20261101.b373ef6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_k4rfk2brwnwu7qb5.svg)](https://markdownregistry.com/a/art_k4rfk2brwnwu7qb5)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 9 versions of this file, between Sep 16, 2026 and Nov 1, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261101.b373ef6 latest2026-11-01 b373ef6 12,178 BB view · diff
git:20261101.6bb5c5b2026-11-01 6bb5c5b 11,497 BB view · diff
git:20261027.b8c5d9a2026-10-27 b8c5d9a 11,497 BB view · diff
git:20261023.e168e362026-10-23 e168e36 11,524 BB view · diff
git:20261007.b1dab1d2026-10-07 b1dab1d 11,336 BB view · diff
git:20261007.66e7aad2026-10-07 66e7aad 11,107 BB view · diff
git:20260926.d5f35a42026-09-26 d5f35a4 10,776 BB view · diff
git:20260926.574d61b2026-09-26 574d61b 10,504 BB view · diff
git:20260916.b3341042026-09-16 b334104 10,362 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12178 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

nerds-odd-e/doughnut · 50 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k4rfk2brwnwu7qb5
GET https://markdownregistry.com/api/v1/resolve?ref=nerds-odd-e/doughnut/linting_formating
GET https://markdownregistry.com/api/v1/blob/1fc07fdcfef4cc1e75a390709d3625e7414def7b291300e261f26984c58e91d8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nerds-odd-e/doughnut

backend-code SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-code/SKILL.md · Backend Java production code, Spring Boot controllers/services/repositories, controller return values, imports, schema…
git:20260928.32163ae · audit A · 50 stars
backend-testing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-testing/SKILL.md · Backend Java tests, controller-level stable-boundary tests, JUnit, @Nested, MakeMe builders, @Transactional…
git:20261003.8204a88 · audit A · 50 stars
backend SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend/SKILL.md · Backend Java — Spring Boot controllers/services, JUnit controller tests, MakeMe. Read this first for any backend work…
git:20260918.3a97b0e · audit A · 50 stars
cli SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cli/SKILL.md · related to donut CLI. Use when working on donut-cli.
git:20260916.b334104 · audit A · 50 stars
cloud-vm-setup SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cloud-vm-setup/SKILL.md · Set up and run the Donut dev environment on Cursor Cloud VM (no Nix). Use when working on Cloud VM, running tests on…
git:20261101.6bb5c5b · audit B · 50 stars
database-erd SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/database-erd/SKILL.md · Regenerate docs/database-erd.md from MySQL information_schema (Mermaid ERD: foreign keys and key columns). Use after…
git:20260826.0b913a6 · audit A · 50 stars
db-migration SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/db-migration/SKILL.md · Database migration, Flyway, SQL migrations, schema changes, database versioning, migration files, squashing historical…
git:20260928.428ed03 · audit A · 50 stars
dough-adr-awareness SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-adr-awareness/SKILL.md · Use and cite this project's current Accepted Architectural Decision Records for architecture-shaped work, follow…
git:20260909.3784459 · audit A · 50 stars
dough-bug-fixing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-bug-fixing/SKILL.md · Resolves a reported discrepancy, defect, or regression by gathering expected versus actual behavior and passing the…
git:20261105.61c0a9a · audit A · 50 stars
dough-execute-plan SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execute-plan/SKILL.md · Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless…
git:20261031.b173027 · audit A · 50 stars
dough-execution-retrospective SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execution-retrospective/SKILL.md · Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits…
git:20261101.f700975 · audit A · 50 stars
dough-land SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-land/SKILL.md · Dough Land lands everything in one reviewed checkout on the authorized remote trunk: commits all of its changes…
git:20261105.61c0a9a · audit A · 50 stars

Every file in nerds-odd-e/doughnut

Browse by kind, by grade B, or by owner.