conventions

Audit code against SEBT Self-Service Portal conventions for PR compliance.

10|1|Updated Nov 7, 2025

Search Tags:#architecture #refactor #conventions #i18n #types #code-review #uswds

Ready to run

npx skills add https://github.com/codeforamerica/sebt-self-service-portal --skill conventions-codeforamerica

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: conventions
Source: https://github.com/codeforamerica/sebt-self-service-portal/tree/main/.claude/skills/conventions
Command: npx skills add https://github.com/codeforamerica/sebt-self-service-portal --skill conventions-codeforamerica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review code against SEBT Self-Service Portal conventions to ensure PRs follow Short, Sharp, Simple principles and improve maintainability.

Core Features & Use Cases

Enforce consistent i18n usage and translation-driven content
Ensure styling and accessibility use USWDS classes and semantic roles
Promote architectural hygiene: centralized types, minimized wrappers, dead code elimination

Quick Start

Review a merged or in-progress PR against CONVENTIONS.md and flag deviations immediately.

Frequently Asked Questions about conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I enforce code conventions during a PR review?▼

You can audit code against documented conventions to enforce PR quality during code reviews. This Skill flags deviations in i18n usage, USWDS styling, centralized type management, and architectural hygiene to ensure PRs meet Short, Sharp, Simple principles.

What are code review conventions for USWDS styling and accessibility?▼

Code review conventions for USWDS styling require frontend components to use USWDS classes and semantic roles. Auditing code ensures styling and accessibility meet these standardized guidelines rather than relying on custom CSS.

Does this convention auditor check i18n usage and centralized type management?▼

Yes, the convention auditor checks i18n usage to enforce translation-driven content and verifies centralized type management. It ensures architectural hygiene by minimizing wrappers and eliminating dead code across frontend and backend components.

How do I clean up a merged PR against repository conventions?▼

To clean up a merged PR against repository conventions, review the code against CONVENTIONS.md and flag deviations immediately. This ongoing repository maintenance ensures the codebase aligns with Short, Sharp, Simple principles.

What is the best way to maintain architectural hygiene in a self-service portal?▼

The best way to maintain architectural hygiene is to audit code against self-service portal conventions. This practice promotes centralized types, minimizes wrappers, and executes dead code elimination across frontend and backend components.