Agent skill

Record

Keep durable architecture decisions, requirements, and system designs in sync.

AGPL-3.0Auto-check passedDevelopment

Install Record

skills CLI

$ npx skills add kdlbs/kandev --skill record -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install kdlbs/kandev record --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/record .claude/skills/record && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .claude/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/kdlbs/kandev/tree/main/.agents/skills/record

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add kdlbs/kandev --skill record -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install kdlbs/kandev record --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/record .agents/skills/record && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .agents/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kdlbs/kandev --skill record -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install kdlbs/kandev record --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/record .cursor/skills/record && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .cursor/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/kdlbs/kandev.git --path .agents/skills/record

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add kdlbs/kandev --skill record -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install kdlbs/kandev record --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/record .gemini/skills/record && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .gemini/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install kdlbs/kandev record

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add kdlbs/kandev --skill record -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/record .github/skills/record && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .github/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kdlbs/kandev --skill record -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install kdlbs/kandev record --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/record .opencode/skills/record && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "record" agent skill from https://github.com/kdlbs/kandev/tree/main/.agents/skills/record into .opencode/skills/record/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "record", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: record
GitHub stars: 909
Token cost: ~831 tokens
SKILL.md length: 329 words
Files: 1
Skills in repo: 45
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Keep durable architecture decisions, requirements, and system designs in sync.

Works in 5 steps: Choose an ID in the form… → Make sure that docs/decisions/.md does… → Create the ADR with the template below. → …
Specification-recording requests
SKILL.md covers Record a decision, ADR procedure, Reconcile specifications and Validation
Calls python3 and git

What it does

Record is an agent skill from kdlbs/kandev. Keep durable architecture decisions, requirements, and system designs in sync. Auto-invoke when a request establishes or changes a long-lived boundary, public contract, ownership rule, operational invariant, or repo-wide convention with meaningful alternatives. Also use for explicit ADR or specification-recording requests.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records. The repository describes itself as: AI Kanban & Development Environment. Orchestrate multiple agents, review changes, open PRs. Multi-provider, self-hostable, no telemetry. The licence is AGPL-3.0.

When your agent uses it

Specification-recording requests
Tasks that involve Architecture decision records

Example prompts

“/record”

Requirements

Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Choose an ID in the form YYYY-MM-DD-short-title.
Make sure that docs/decisions/.md does not exist.
Create the ADR with the template below.
Run python3 scripts/list-docs.py decisions --format paths to confirm the
Reconcile affected specifications.

What it can do on your machine

Read from SKILL.md and the folder at commit b734113. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python3
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Record loads about 831 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~83
When it runs · the whole SKILL.md, loaded when a task matches: ~831

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kdlbs/kandev at commit b734113, republished under its AGPL-3.0 licence (© kdlbs). 329 words, ~831 tokens.

Download SKILL.mdSave it as .claude/skills/record/SKILL.md (or your agent's skills folder).

name: record
description: Keep durable architecture decisions, requirements, and system designs in sync. Auto-invoke when a request establishes or changes a long-lived boundary, public contract, ownership rule, operational invariant, or repo-wide convention with meaningful alternatives. Also use for explicit ADR or specification-recording requests.

Record Knowledge

Record significant decisions for future work. Reconcile the affected requirements and system designs after the decision.

Record a decision

Create an ADR when all statements are true:

The choice creates a durable constraint, boundary, contract, ownership rule, operational invariant, or repository-wide convention.
Meaningful alternatives have different trade-offs.
Future work must follow or supersede the choice.
A requirement, system design, test, or work order does not preserve enough rationale.

Do not create an ADR for a simple feature, local refactor, routine dependency change, plan sequence, or temporary migration step.

ADR procedure

Choose an ID in the form YYYY-MM-DD-short-title.
Make sure that docs/decisions/<id>.md does not exist.
Create the ADR with the template below.
Run python3 scripts/list-docs.py decisions --format paths to confirm the new ADR is discoverable. Do not edit a catalog row.
Reconcile affected specifications.

Existing numeric ADR IDs remain valid. Do not rename them.

markdown

# ADR-YYYY-MM-DD-short-title: Short title

**Status:** accepted | superseded by <adr-id> | deprecated
**Date:** YYYY-MM-DD
**Area:** backend | frontend | infra | protocol | workflow

## Context

Explain the situation and the need for a decision.

## Decision

State the selected rule, boundary, or contract.

## Consequences

State benefits, costs, and follow-up constraints.

## Alternatives Considered

State each meaningful alternative and why it was not selected.

Reconcile specifications

Read docs/specs/README.md, the owning system README.md, and the relevant files in docs/specs/guide/. Use the catalog command to locate the owning requirements and designs.

Apply these rules:

Confirm the owning system from the durable contract. Do not assign ownership to UI only because users observe the decision there.
If the decision changes observable behavior, update the owning requirement and its REQ-* or AC-* criteria.
If the decision changes technical boundaries or contracts, update the owning system design.
If both change, update both artifacts and preserve their references.
If the decision is internal and does not change a documented design, the ADR is sufficient.
If no product system applies, state that fact in the ADR.

Do not copy the ADR into requirements or system design. Link the ADR from the affected design. Requirements contain observable outcomes, not decision rationale.

During legacy migration, use this command to locate existing sources:

python3 scripts/list-docs.py specs --kind legacy --format paths

Do not create a new generic spec.md file.

Validation

Run:

bash

python3 scripts/lint-spec-files.py --all
python3 scripts/list-docs.py validate
git diff --check -- docs/decisions docs/specs

Report the ADR, affected requirement IDs, affected system designs, and the validation result.

Files

Just SKILL.md in .agents/skills/record of kdlbs/kandev.

Open the folder on GitHubat commit b734113

Compare with similar skills

Record next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Record compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Record this skillkdlbs/kandev	909	—	~831	Automated safety check: Pass	AGPL-3.0	today
PR Design DocOpenHands/OpenHands	90k	—	~2.4k	Automated safety check: Pass	MIT	today
Cto AdvisorIbrahim-3d/orchestrator-supaconductor	380	4 repos	~2.4k	Automated safety check: Pass	MIT	11 days ago
Improve Codebase Architectureywwynm/EverythingDone	144	15 repos	~1.3k	Automated safety check: Pass	GPL-3.0	24 days ago
Domain Modelingbrim-borium/spotify_sdk	166	5 repos	~806	Automated safety check: Pass	Apache-2.0	yesterday
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid	175	1 repos	~5.6k	Automated safety check: Pass	None	1 mo ago

Similar skills

PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
90k GitHub stars~2.4k tokensUpdated today
DevelopmentAuto-check passed
Cto Advisor
Ibrahim-3d/orchestrator-supaconductor
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.
380 GitHub starsUsed in 4 repos~2.4k tokens
DevelopmentAuto-check passed
Improve Codebase Architecture
ywwynm/EverythingDone
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
144 GitHub starsUsed in 15 repos~1.3k tokens
DevelopmentAuto-check passed
Domain Modeling
brim-borium/spotify_sdk
Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.
166 GitHub starsUsed in 5 repos~806 tokens
DevelopmentAuto-check passed
Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
175 GitHub starsUsed in 1 repo~5.6k tokens
DevelopmentAuto-check passed
Learning Opportunities
DrCatHicks/learning-opportunities
Facilitates deliberate skill development during AI-assisted coding.
2.5k GitHub stars~2.5k tokensUpdated 1 mo ago
DevelopmentAuto-check passed

Questions about Record

What does Record do?

Keep durable architecture decisions, requirements, and system designs in sync. Record is an agent skill from kdlbs/kandev. Keep durable architecture decisions, requirements, and system designs in sync.

When should I use Record?

Record fits situations like: specification-recording requests; tasks that involve Architecture decision records.

How do I install Record in Claude Code?

Run `npx skills add kdlbs/kandev --skill record -a claude-code`. Or copy the skill folder (.agents/skills/record in kdlbs/kandev) into .claude/skills/record in your project. Claude Code loads it when a task matches its description.

How do I install Record in Codex?

Run `npx skills add kdlbs/kandev --skill record -a codex`. Or copy the skill folder (.agents/skills/record in kdlbs/kandev) into .agents/skills/record in your project. Codex loads it when a task matches its description.

Can I use Record in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kdlbs/kandev --skill record -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/record, .gemini/skills/record, .github/skills/record and .opencode/skills/record in your project.

What does Record need to run?

Going by SKILL.md and its folder, Record needs the command-line tools its instructions call (python3 and git). Our summary lists: Python 3.

Does Record access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Record safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Record use?

Record is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Record use?

About 831 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Record?

Skills that share tags, products or a category with Record: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 380 stars), Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars) and Domain Modeling (brim-borium/spotify_sdk, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Record?

kdlbs (a GitHub organization) maintains it in kdlbs/kandev, which has 909 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 8, 2026.

Source: kdlbs/kandev on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Record

Install Record

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Record Knowledge

Record a decision

ADR procedure

Reconcile specifications

Validation

Files

Compare with similar skills

Similar skills

PR Design Doc

Cto Advisor

Improve Codebase Architecture

Domain Modeling

Design Doc Mermaid

Learning Opportunities

More from kdlbs/kandev

PR Walkthrough

Debug

Harness Improvement

Diagram Design

TDD

Verify

Questions about Record

Install Record

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Record Knowledge

Record a decision

ADR procedure

Reconcile specifications

Validation

Files

Compare with similar skills

Similar skills

More from kdlbs/kandev

Related

Questions about Record