Conventions

SkillDocs & knowledge

Always-on conventions for TypeScript monorepos. Use when writing or reviewing TypeScript, markdown, or tests, when handling secrets, env vars, or input at trust boundaries, or any time you would otherwise reach for a project style guide. Bundles code style, JSDoc, markdown structure, plain language, security, testing, and USA English rules.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Conventions skill

What this skill tells your AI

The instructions your AI receives, as published by stijnvanhulle/template in .agents/skills/conventions/SKILL.md and read by ahel’s review.

This skill ships the rules the template repo keeps in .agents/skills/conventions/rules/. When the plugin is installed in another project, the same files load on demand from here instead.

plain-language, security, and usa-english apply to every request. The rest carry paths: frontmatter and load when you open a matching file.

Read the file that matches what you are doing:

  • rules/code-style.md for ESM conventions, naming, imports, and exports.
  • rules/jsdoc.md for the JSDoc essentials. The full reference lives in the separate jsdoc skill.
  • rules/markdown.md for markdown structure. The documentation and humanizer skills cover writing voice and SEO.
  • rules/plain-language.md for the ISO 24495-1 plain language standard that agent responses and other user-facing output follow.
  • rules/security.md for secrets, input validation at trust boundaries, and safe shell use.
  • rules/testing.md for Vitest patterns and what to test.
  • rules/usa-english.md for the USA English spelling convention used across code, comments, and docs.

If a rule conflicts with a project-specific instruction in AGENTS.md or CLAUDE.md, the project instruction wins.

Signals

GitHub stars
34
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
conventions-stijnvanhulle
Source
github.com/stijnvanhulle/template