Agentops standards

Language-specific coding standards and validation rules. Provides Python, Go, Rust, TypeScript, Shell, YAML, JSON, and Markdown standards. Auto-loaded by $vibe, $implement, $doc, $bug-hunt, $complexity based on file types.

install
source · Clone the upstream repo
git clone https://github.com/boshu2/agentops
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/boshu2/agentops "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills-codex/standards" ~/.claude/skills/boshu2-agentops-standards && rm -rf "$T"
manifest: skills-codex/standards/SKILL.md
source content

Standards Skill

Language-specific coding standards loaded on-demand by other skills.

Purpose

This is a library skill - it doesn't run standalone but provides standards references that other skills load based on file types being processed.

Standards Available

StandardReferenceLoaded By
Skill Structure
references/skill-structure.md
vibe (skill audits), doc (skill creation)
Python
references/python.md
vibe, implement, complexity
Go
references/go.md
vibe, implement, complexity
Rust
references/rust.md
vibe, implement, complexity
TypeScript
references/typescript.md
vibe, implement
Shell
references/shell.md
vibe, implement
YAML
references/yaml.md
vibe
JSON
references/json.md
vibe
Markdown
references/markdown.md
vibe, doc
SQL Safety
references/sql-safety-checklist.md
vibe, pre-mortem (when DB code detected)
LLM Trust Boundaries
references/llm-trust-boundary-checklist.md
vibe, pre-mortem (when LLM code detected)
Race Conditions
references/race-condition-checklist.md
vibe, pre-mortem (when concurrent code detected)
Codex Skills
references/codex-skill.md
vibe (when
skills-codex/
or converter files detected)
Behavioral Discipline
references/behavioral-discipline.md
implement, review, vibe, pre-mortem
Test Pyramid
references/test-pyramid.md
plan, pre-mortem, implement, crank, validation, post-mortem

How It Works

Skills declare

standards
as a dependency:

skills:
  - standards

Then load the appropriate reference based on file type:

# Pseudo-code for standard loading
if file.endswith('.py'):
    load('standards/references/python.md')
elif file.endswith('.go'):
    load('standards/references/go.md')
elif file.endswith('.rs'):
    load('standards/references/rust.md')
# etc.

Domain-Specific Checklists

Specialized checklists for high-risk code patterns. Loaded automatically by

$vibe
and
$pre-mortem
when matching code patterns are detected:

ChecklistTrigger PatternRisk Area
sql-safety-checklist.md
SQL queries, ORM calls, migration files,
database/sql
,
sqlalchemy
,
prisma
Injection, migration safety, N+1, transactions
llm-trust-boundary-checklist.md
anthropic
,
openai
imports, prompt templates,
*llm*
/
*prompt*
files
Prompt injection, output validation, cost control
race-condition-checklist.md
Goroutines, threads,
asyncio
,
sync.Mutex
, shared file I/O
Shared state, file races, database races
codex-skill.md
Files under
skills-codex/
,
convert.sh
,
skills-codex-overrides/
Codex API conformance, prohibited primitives, tool mapping
behavioral-discipline.md
Execution, review, or plan-validation tasks with ambiguity or broad blast radiusHidden assumptions, overbuilding, drive-by edits, weak verification

Skills detect triggers via file content patterns and import statements. Each checklist's "When to Apply" section defines exact detection rules.

Deep Standards

For comprehensive audits, skills can load extended standards from

vibe/references/*-standards.md
which contain full compliance catalogs.

StandardSizeUse Case
Tier 1 (this skill)~5KB eachNormal validation
Tier 2 (vibe/references)~15-20KB eachDeep audits,
--deep
flag
Domain checklists~3-5KB eachTriggered by code pattern detection

Integration

Skills that use standards:

  • $vibe
    - Loads based on changed file types
  • $implement
    - Loads for files being modified
  • $review
    - Loads for change-quality and blast-radius checks
  • $doc
    - Loads markdown standards
  • $bug-hunt
    - Loads for root cause analysis
  • $complexity
    - Loads for refactoring recommendations

Examples

Vibe Loads Python Standards

User says:

$vibe
(detects changed Python files)

What happens:

  1. Vibe skill checks git diff for file types
  2. Vibe finds
    auth.py
    in changeset
  3. Vibe loads
    standards/references/python.md
    automatically
  4. Vibe validates against Python standards (type hints, docstrings, error handling)
  5. Vibe reports findings with standard references

Result: Python code validated against language-specific standards without manual reference loading.

Implement Loads Go Standards

User says:

$implement ag-xyz-123
(issue modifies Go files)

What happens:

  1. Implement skill reads issue metadata to identify file targets
  2. Implement finds
    server.go
    in implementation scope
  3. Implement loads
    standards/references/go.md
    for context
  4. Implement writes code following Go standards (error handling, naming, package structure)
  5. Implement validates output against loaded standards before committing

Result: Go code generated conforming to standards, reducing post-implementation vibe findings.

Troubleshooting

ProblemCauseSolution
Standards not loadedFile type not detected or standards skill missingCheck file extension matches reference; verify standards in dependencies
Wrong standard loadedFile type misidentified (e.g., .sh as .bash)Manually specify standard; update file type detection logic
Deep standards missingVibe needs extended catalog, not foundCheck
vibe/references/*-standards.md
exists; use
--deep
flag
Standard conflictsMultiple languages in same changesetLoad all relevant standards; prioritize by primary language

Reference Documents

Local Resources

references/

scripts/

  • scripts/validate.sh