convention SKILL.md skillA

convention from lamngockhuong/aiteamkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add lamngockhuong/aiteamkit/convention@git:20261014.03c655e

Pins git:20261014.03c655e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
lamngockhuong/aiteamkit
Path
plugins/atk/skills/convention/SKILL.md
Versions recorded
4
Latest version
git:20261014.03c655e, committed Oct 14, 2026
First version recorded
Oct 1, 2026
Size
18,412 bytes
Repository stars
9
License
MIT

Extract, record, and enforce the coding conventions a team actually follows: branch and commit rules, naming, layering, error handling, test layout, review etiquette, and the tooling that enforces each rule. Also drafts the collaboration files the project lacks, `CONTRIBUTING.md`, the pull request template, and `CODEOWNERS`, writing only the ones the team picks. Use when a team has no written convention, when the written one no longer matches the code, or when reviews keep repeating the same…

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

# Team Conventions (`atk:convention`)

Writes down the rules a team already follows and enforces. It can also suggest rules from published
standards, and each one stays a proposal until the Tech Lead adopts it; nothing is imported on the
team's behalf. A rule that no tool enforces and no reviewer checks is a wish; this skill labels it as
one.

## Scope

Handles: deriving conventions from the existing codebase and git history, recording them, mapping
each rule to the tool that enforces it, auditing whether the code still matches the document, suggesting rules from
the published standards for the detected stack as proposals, and offering to draft the collaboration files the project does not have yet.

Does NOT handle: reviewing a specific change (`atk:review`), configuring CI pipelines beyond the
lint and format layer, or choosing the tech stack.

## Roles

Tech Lead owns the document and is the approver. Every Dev is bound by it. A rule added without the
team agreeing is a proposal, marked as such. See `shared/team-roles.md`.

## Invocation

```bash
/atk:convention                   # Derive from the codebase and write or update the document
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lamngockhuong/aiteamkit/convention@sha256:de8a731a2e3dda10

The line at the top of this page pins the label git:20261014.03c655e, 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_yjwocumyt36cwsxc.svg)](https://markdownregistry.com/a/art_yjwocumyt36cwsxc)

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

Versions

The registry has recorded 4 versions of this file, between Oct 1, 2026 and Oct 14, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261014.03c655e latest2026-10-14 03c655e 18,412 BA view · diff
git:20261010.48f2f0b2026-10-10 48f2f0b 18,128 BA view · diff
git:20261002.22b4c082026-10-02 22b4c08 17,867 BA view · diff
git:20261001.ed023842026-10-01 ed02384 17,986 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18412 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
  • pass: No script tag

Source

GitHub

lamngockhuong/aiteamkit · 9 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yjwocumyt36cwsxc
GET https://markdownregistry.com/api/v1/resolve?ref=lamngockhuong/aiteamkit/convention
GET https://markdownregistry.com/api/v1/blob/de8a731a2e3dda10c43c5c8ab23a3be5e718d1ad1bcd7ab7dca6bd6267ed0cec

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 lamngockhuong/aiteamkit

CLAUDE.md CLAUDE.md file
lamngockhuong/aiteamkit · CLAUDE.md
git:20261021.3a0c95b · audit A · 9 stars
breakdown SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/breakdown/SKILL.md · Break an epic or a design document into owned, sequenced tasks: one deliverable each, an owner, a dependency order, the…
git:20261014.03c655e · audit A · 9 stars
catchup SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/catchup/SKILL.md · Summarise an epic or a pull request for someone not in the conversation that produced it: what the work is and for…
git:20261021.ae774f4 · audit A · 9 stars
design-doc SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/design-doc/SKILL.md · Write the technical design document a team reviews before coding, plus its ADR: current state, options with trade-offs…
git:20261021.ae774f4 · audit A · 9 stars
estimate SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/estimate/SKILL.md · Estimate a backlog and fill a sprint against real team capacity: size each item with a stated basis, mark the…
git:20261014.03c655e · audit A · 9 stars
fix SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/fix/SKILL.md · Fix a defect the way a team reviewer will accept: capture the failure verbatim, prove the cause before changing a line…
git:20261021.ae7ef05 · audit A · 9 stars
git SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/git/SKILL.md · Carry a finished piece of work into version control: read what changed, stage it after scanning for anything that must…
git:20261015.10f30b1 · audit A · 9 stars
handover SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/handover/SKILL.md · Hand work over to another person or team so nothing depends on the leaver's memory: the true state of each item…
git:20261014.03c655e · audit A · 9 stars
help SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/help/SKILL.md · Answer which atk skill to run. With no argument it reads the state of the project, meaning the profile, the artifacts…
git:20261021.ae774f4 · audit A · 9 stars
implement SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/implement/SKILL.md · Write the code for a piece of work the way a team will accept it: decide whether the work needs a plan before a line is…
git:20261021.3a0c95b · audit A · 9 stars
incident SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/incident/SKILL.md · Run a production incident and close it properly: a timeline built from evidence, impact and severity, the proven root…
git:20261014.03c655e · audit A · 9 stars
init SKILL.md skill
lamngockhuong/aiteamkit · plugins/atk/skills/init/SKILL.md · Set up atk in a project: read the repository to find the build, test, and lint commands, the layer layout, the tracker…
git:20261019.7d1071a · audit A · 9 stars

Every file in lamngockhuong/aiteamkit

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