global--conventions_skill

Overview

This skill applies the Agent OS standard for global conventions across TypeScript projects. It encodes consistent naming, formatting, and structural conventions to ensure uniform behavior and readability. Use it to automatically align code and documentation with the agreed global rules.

How this skill works

The skill inspects project files and identifies areas that deviate from the Agent OS global conventions, including naming patterns, file organization, and configuration defaults. It reports nonconforming items and provides concrete suggestions or diffs to bring files into compliance. Optionally, it can generate small automated fixes for straightforward violations.

When to use it

• Onboarding new repositories to ensure they match organization-wide conventions
• During pull request reviews to flag convention violations early
• Before releases to ensure consistent public-facing behavior and docs
• When standardizing multiple projects to reduce cognitive overhead
• As part of CI checks to enforce automated compliance

Best practices

• Run the skill early in development and integrate into CI to catch issues quickly
• Review suggested changes before applying automated fixes for complex files
• Treat the skill's output as prescriptive for conventions, not as optional style feedback
• Keep the conventions updated and versioned so projects can migrate smoothly
• Apply changes incrementally for large repos to limit merge conflicts

Example use cases

• Check a TypeScript library for naming and export conventions before publishing
• Enforce consistent file and folder layout across microservices
• Automate detection of deprecated patterns that violate current global rules
• Standardize configuration files (lint, build, doc headers) across a mono-repo
• Integrate with CI to block merges that introduce convention regressions