New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Setup

by rvdbreemen in rvdbreemen/OTGW-firmware

One-time project setup for adr-kit. An agent skill from rvdbreemen/OTGW-firmware.

GPL-3.0Auto-check passedDevelopment

Install Setup

skills CLI
$ npx skills add rvdbreemen/OTGW-firmware --skill setup -a claude-code

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

GitHub CLI
$ gh skill install rvdbreemen/OTGW-firmware setup --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/rvdbreemen/OTGW-firmware.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/adr-kit/skills/setup .claude/skills/setup && 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/

Facts

Skill name
setup
GitHub stars
207
Token cost
~964 tokens
SKILL.md length
410 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
GPL-3.0

At a glance

One-time project setup for adr-kit. An agent skill from rvdbreemen/OTGW-firmware.

  • Works in 4 steps: Locate the project's CLAUDE.md. It lives… → Idempotency check. If CLAUDE.md exists,… → Append or create. If CLAUDE.md exists… → …
  • Tasks that involve Architecture decision records
  • SKILL.md covers Steps, Snippet to append, Constraints and Reporting format, plus 1 more section
  • Reaches github.com

What it does

Setup is an agent skill from rvdbreemen/OTGW-firmware. One-time project setup for adr-kit. Appends an "ADR Kit Rules" section to the project's CLAUDE.md (creating the file if it does not exist) so future sessions know about the ADR skill, agent, and instructions. Idempotent: skips the append if the section is already present.

Its SKILL.md is about 960 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 and Agent instruction files. It works with Home Assistant. The repository describes itself as: A ESP8266 devkit firmware for the Nodoshop version of the Opentherm Gateway (OTGW). The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Architecture decision records
  • Tasks that involve Agent instruction files

Example prompts

  • “ADR Kit Rules”
  • “/setup”

Requirements

  • Pre-approved tools (allowed-tools): [Read, Write, Edit]

Workflow steps

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

  1. Locate the project's CLAUDE.md. It lives at the repository root. The user is expected to run /adr-kit:setup from the project root. Check…
  2. Idempotency check. If CLAUDE.md exists, read it. If it already contains a heading exactly named ## ADR Kit Rules (case-sensitive, exact…
  3. Append or create. If CLAUDE.md exists but lacks the section, append the snippet below to the end of the file, with one blank line…
  4. Confirm. Reply with one short line that names the action taken (created, appended, or skipped), the path to the file, and the line number…

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • [Read
    • Write
    • Edit]

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Setup loads about 964 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 410 words of instructions outside code blocks.

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

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 rvdbreemen/OTGW-firmware at commit 5e66c3b, republished under its GPL-3.0 licence (© rvdbreemen). 410 words, ~964 tokens.

Download SKILL.mdSave it as .claude/skills/setup/SKILL.md (or your agent's skills folder).
name
setup
description
One-time project setup for adr-kit. Appends an "ADR Kit Rules" section to the project's CLAUDE.md (creating the file if it does not exist) so future sessions know about the ADR skill, agent, and instructions. Idempotent: skips the append if the section is already present.
allowed-tools
[Read, Write, Edit]
disable-model-invocation
true

adr-kit setup

You are running the one-time project setup for the adr-kit plugin. Your job is to append a small "ADR Kit Rules" section to the project's CLAUDE.md so future Claude Code sessions in this project know about the ADR skill, the adr-generator subagent, and the path-specific coding and review instructions.

Steps

  1. Locate the project's CLAUDE.md. It lives at the repository root. The user is expected to run /adr-kit:setup from the project root. Check whether CLAUDE.md exists in the current working directory.

  2. Idempotency check. If CLAUDE.md exists, read it. If it already contains a heading exactly named ## ADR Kit Rules (case-sensitive, exact heading text), do nothing. Tell the user the setup is already done and exit. Do not duplicate the section.

  3. Append or create. If CLAUDE.md exists but lacks the section, append the snippet below to the end of the file, with one blank line separating it from whatever was the last content. If CLAUDE.md does not exist, create it containing only the snippet (no other scaffolding).

  4. Confirm. Reply with one short line that names the action taken (created, appended, or skipped), the path to the file, and the line number of the new section's heading.

Snippet to append

markdown
## ADR Kit Rules

This project uses [adr-kit](https://github.com/rvdbreemen/adr-kit) for Architecture Decision Records. The skill, the `adr-generator` subagent, and the path-specific instructions are loaded via the plugin.

- Use `/adr-kit:adr` (or invoke the `adr-generator` subagent) when authoring a new ADR.
- During coding work, follow the rules in the plugin's `instructions/adr.coding.md`.
- During code review, apply the six named ADR checks in the plugin's `instructions/adr.review.md`.
- An ADR cannot flip from `Proposed` to `Accepted` until it passes all four verification gates: Completeness, Evidence, Clarity, Consistency.

ADR files live at `docs/adr/ADR-XXX-title.md`. Status flow: `Proposed` to `Accepted`, then immutable. To reverse a decision, write a superseding ADR rather than editing the original.
Show full SKILL.md (207 more words)Show less

Constraints

  • Idempotent. The only state mutation is the append. Re-running /adr-kit:setup must not duplicate the section. Always do the heading-presence check first.
  • Read before write. Always read CLAUDE.md (when it exists) before deciding whether to use Edit or Write. Never overwrite existing content.
  • Preserve existing content. Do not modify or remove anything else in CLAUDE.md. Append only, or create from scratch.
  • No em dashes. Per adr-kit's own style. The snippet uses colons, periods, parentheses, and commas only.
  • English. The snippet is in English regardless of the rest of the user's CLAUDE.md.

Reporting format

Reply with exactly one of these forms:

  • Setup complete. Appended "ADR Kit Rules" section to CLAUDE.md at line <N>.
  • Setup complete. Created CLAUDE.md with the "ADR Kit Rules" section.
  • Already set up. CLAUDE.md already contains an "ADR Kit Rules" heading at line <N>. No changes made.

When the user is in the wrong directory

If you cannot find a sensible project root (no CLAUDE.md, no .git/, no package.json or other manifest), stop and ask: "I do not see a project root here (no CLAUDE.md, no .git, no package manifest). Are you in your project directory? If yes, I can create CLAUDE.md from scratch. Confirm to proceed."

Do not silently create files in unexpected locations.

© rvdbreemen, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in tools/adr-kit/skills/setup of rvdbreemen/OTGW-firmware.

Open the folder on GitHubat commit 5e66c3b

Compare with similar skills

Setup 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.

Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup this skillrvdbreemen/OTGW-firmware207—~964Automated safety check: PassGPL-3.0
Rememberantonio-orionus/Arroxy389—~571Automated safety check: PassMIT
Grounding A Designandrew-blake/melcloudhome142—~1.1kAutomated safety check: PassMIT
Ad DriftCorridorTech/PoseCap224—~1.8kAutomated safety check: NotesApache-2.0
Documentationextra-org/extra113—~848Automated safety check: PassMIT
Expectationscitypaul/.dotfiles739—~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Remember

    antonio-orionus/Arroxy

    Persists a durable Arroxy lesson — a gotcha, user preference, workflow rule, or design decision — to the right tracked file (project memory, AGENTS.md, CONTEXT.md, dev-docs, or an ADR) so any coding…

    389 GitHub stars~571 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

  • Grounding A Design

    andrew-blake/melcloudhome

    A skill your agent uses when about to propose, brainstorm, review or revise a design, fix approach or plan for a feature or behaviour change in this repo, including "brief" or "quick" design…

    142 GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Ad Drift

    CorridorTech/PoseCap

    Read-only drift audit — compare AGENTS.md, ARCHITECTURE.md, ADR statuses, feature specs in doc/specs/, and documentation discipline against what the code actually does.

    224 GitHub stars~1.8k tokensUpdated yesterday
    DevelopmentAuto-check: notes

  • Documentation

    extra-org/extra

    Keep the repository's documentation accurate, honest, and synchronized with the code.

    113 GitHub stars~848 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

  • Expectations

    citypaul/.dotfiles

    Decide where a learning, gotcha, or decision should live so it is not lost, and capture it there while context is fresh.

    739 GitHub stars~1.2k tokensUpdated 6 days ago
    DevelopmentAuto-check passed

  • Ad Review

    CorridorTech/PoseCap

    Two-axis fresh-context code review per WORKFLOW §10. An agent skill from CorridorTech/PoseCap.

    224 GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from rvdbreemen/OTGW-firmware

All 13 skills in this repo

  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Auto-check passed

  • PPTX

    rvdbreemen/OTGW-firmware

    Use this skill any time a .pptx file is involved in any way — as input, output, or both.

    207 GitHub starsUsed in 35 repos~2.3k tokens
    Auto-check passed

  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Auto-check passed

  • Implement Next Task

    rvdbreemen/OTGW-firmware

    Drive the autonomous 2.0.0 ESP32-S3-only async + FreeRTOS migration (epic TASK-865).

    207 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed

  • Beta Prerelease

    rvdbreemen/OTGW-firmware

    Publish an OTGW-firmware beta prerelease — bump VERSIONPRERELEASE, push to otgw-1.x.x, tag, and let CI build + publish the GitHub prerelease

    207 GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check passed

  • Lint

    rvdbreemen/OTGW-firmware

    Lints existing Architecture Decision Records against the four verification gates (Completeness, Evidence, Clarity, Consistency).

    207 GitHub stars~4.3k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Setup

What does Setup do?

One-time project setup for adr-kit. An agent skill from rvdbreemen/OTGW-firmware. Setup is an agent skill from rvdbreemen/OTGW-firmware. One-time project setup for adr-kit.

When should I use Setup?

Setup fits situations like: tasks that involve Architecture decision records; tasks that involve Agent instruction files.

How do I install Setup in Claude Code?

Run `npx skills add rvdbreemen/OTGW-firmware --skill setup -a claude-code`. Or copy the skill folder (tools/adr-kit/skills/setup in rvdbreemen/OTGW-firmware) into .claude/skills/setup in your project. Claude Code loads it when a task matches its description.

How do I install Setup in Codex?

Run `npx skills add rvdbreemen/OTGW-firmware --skill setup -a codex`. Or copy the skill folder (tools/adr-kit/skills/setup in rvdbreemen/OTGW-firmware) into .agents/skills/setup in your project. Codex loads it when a task matches its description.

Can I use Setup 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 rvdbreemen/OTGW-firmware --skill setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup, .gemini/skills/setup, .github/skills/setup and .opencode/skills/setup in your project.

What does Setup need to run?

SKILL.md names no scripts, command-line tools or credentials: Setup is instructions for the agent only. Its frontmatter pre-approves these tools: [Read, Write, Edit].

Does Setup access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Setup 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 Setup use?

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

How many tokens does Setup use?

About 964 tokens (SKILL.md is roughly 3.9k 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 Setup?

Skills that share tags, products or a category with Setup: Remember (antonio-orionus/Arroxy, 389 stars), Grounding A Design (andrew-blake/melcloudhome, 142 stars), Ad Drift (CorridorTech/PoseCap, 224 stars) and Documentation (extra-org/extra, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup?

rvdbreemen (a GitHub user) maintains it in rvdbreemen/OTGW-firmware, which has 207 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 6, 2026.

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