Home / lamngockhuong / aiteamkit · skills/convention/SKILL.md · GitHub

convention skillA

convention is agent-read markdown (skill) from lamngockhuong/aiteamkit: 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 automatically. Also offers to draft the collaboration files the project has none of, `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, when reviews k.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add lamngockhuong/aiteamkit/convention@git:20260923.3195eb0
Exact content
mdr add lamngockhuong/aiteamkit/convention@sha256:56420a8c8ad7215a

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tsatxe2eowuee4iz.svg)](https://markdownregistry.com/a/art_tsatxe2eowuee4iz)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.3195eb0 latest2026-09-23 3195eb0 17,986 BA view · diff
git:20260922.3896e1f2026-09-22 3896e1f 16,324 BA view · diff
git:20260922.c7615a52026-09-22 c7615a5 15,455 BA view · diff
git:20260920.89d3fa32026-09-20 89d3fa3 15,109 BA view · diff
git:20260920.d282a912026-09-20 d282a91 9,716 BA view · diff
git:20260918.f67e5b52026-09-18 f67e5b5 9,378 BA view · diff
git:20260918.73a33f42026-09-18 73a33f4 6,724 BA view · diff
git:20260918.911e9832026-09-18 911e983 6,618 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (17986 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 · 5 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tsatxe2eowuee4iz
GET https://markdownregistry.com/api/v1/resolve?ref=lamngockhuong/aiteamkit/convention
GET https://markdownregistry.com/api/v1/blob/56420a8c8ad7215ab20b5e04825ef99421e074ea5e8ba344d27e49fa002615d5

Your agent 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.

More from lamngockhuong/aiteamkit

CLAUDE.md claude
lamngockhuong/aiteamkit · CLAUDE.md
git:20260924.59d6cfa · audit A · 5 stars
breakdown skill
lamngockhuong/aiteamkit · 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:20260922.c7615a5 · audit A · 5 stars
catchup skill
lamngockhuong/aiteamkit · skills/catchup/SKILL.md · Summarise an epic or a pull request for someone who was not in the conversation that produced it: what the work is and…
git:20260921.7fc6a05 · audit A · 5 stars
design-doc skill
lamngockhuong/aiteamkit · skills/design-doc/SKILL.md · Write the technical design document a team reviews before coding, plus the ADR that records the decision behind it…
git:20260924.59d6cfa · audit A · 5 stars
estimate skill
lamngockhuong/aiteamkit · 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:20260922.c7615a5 · audit A · 5 stars
fix skill
lamngockhuong/aiteamkit · 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:20260922.2c10be8 · audit A · 5 stars
git skill
lamngockhuong/aiteamkit · 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:20260922.2c10be8 · audit A · 5 stars
handover skill
lamngockhuong/aiteamkit · 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:20260920.d282a91 · audit A · 5 stars
help skill
lamngockhuong/aiteamkit · 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:20260923.1028253 · audit A · 5 stars
implement skill
lamngockhuong/aiteamkit · 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:20260924.59d6cfa · audit A · 5 stars
incident skill
lamngockhuong/aiteamkit · skills/incident/SKILL.md · Run a production incident and close it properly: a timeline built from evidence, impact and severity, the proven root…
git:20260922.c7615a5 · audit A · 5 stars
init skill
lamngockhuong/aiteamkit · 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:20260924.59d6cfa · audit A · 5 stars

Every file in lamngockhuong/aiteamkit

Other files named convention

convention skill
kochetkov-ma/claude-brewcode · brewcode/.codex/skills/convention/SKILL.md · Extracts etalon classes, patterns, architecture into convention docs. Triggers: extract conventions, etalon classes.
git:20260719.ea944a3 · audit A · 32 stars
convention skill
kochetkov-ma/claude-brewcode · .codex/plugins/brewcode/skills/convention/SKILL.md · Extracts etalon classes, patterns, architecture into convention docs. Triggers: extract conventions, etalon classes.
git:20260719.ea944a3 · audit A · 32 stars
convention skill
kochetkov-ma/claude-brewcode · brewcode/skills/convention/SKILL.md · Extracts etalon classes, patterns, architecture into convention docs. Triggers: extract conventions, etalon classes.
git:20260816.765ccc1 · audit A · 32 stars

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