Agent skill

Hier Config New Driver

by netdevops in netdevops/hier_config

A skill your agent uses when adding hierconfig support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver…

MITAuto-check passedDevelopment

Install Hier Config New Driver

skills CLI
$ npx skills add netdevops/hier_config --skill hier-config-new-driver -a claude-code

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

GitHub CLI
$ gh skill install netdevops/hier_config hier-config-new-driver --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/netdevops/hier_config.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/hier-config-new-driver .claude/skills/hier-config-new-driver && 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
hier-config-new-driver
GitHub stars
150
Token cost
~1.3k tokens
SKILL.md length
369 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding hierconfig support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver…

  • Works in 6 steps: Characterize the Platform → Write the Failing Test First (TDD) → Scaffold the Driver → …
  • Adding hierconfig support for a new network platform
  • SKILL.md covers Step 1: Characterize the…, Step 2: Write the Failing Test…, Step 3: Scaffold the Driver and Step 4: Register the Platform, plus 2 more sections
  • Calls poetry

What it does

Hier Config New Driver is an agent skill from netdevops/hier_config. Use when adding hierconfig support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver rules and tests for an unsupported vendor.

Its SKILL.md is about 1.3k 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 Project scaffolding. The repository describes itself as: Hierarchical Configuration. The licence is MIT.

When your agent uses it

  • Adding hierconfig support for a new network platform
  • Operating system — creating a platform driver
  • Registering a new Platform enum member
  • Scaffolding driver rules and tests for an unsupported vendor

Example prompts

  • “/hier-config-new-driver”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Characterize the Platform
  2. Write the Failing Test First (TDD)
  3. Scaffold the Driver
  4. Register the Platform
  5. Document and Log
  6. Run the Gates

What it can do on your machine

Read from SKILL.md and the folder at commit 806c654. 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:

    • poetry

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

  • Network

    No URLs in SKILL.md.

    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

Hier Config New Driver loads about 1.3k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 369 words of instructions outside code blocks.

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

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 netdevops/hier_config at commit 806c654, republished under its MIT licence (© netdevops). 369 words, ~1,259 tokens.

Download SKILL.mdSave it as .claude/skills/hier-config-new-driver/SKILL.md (or your agent's skills folder).
name
hier-config-new-driver
description
Use when adding hier_config support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver rules and tests for an unsupported vendor.

Build a New hier_config Platform Driver

Scaffold an in-tree platform driver the way this repo expects. The authoritative recipe is docs/dev/extending.md; this skill adds the concrete templates. For a driver that lives outside this repo (in user code), follow docs/user/custom-drivers.md#creating-a-custom-driver instead.

Step 1: Characterize the Platform

Answer these before writing code — they determine which overrides and rules the driver needs. Study real config samples from the platform:

QuestionDriver hook if non-default
Negation prefix (no ? undo ? delete ?)negation_prefix property (default "no ")
Some commands reset with a different form?NegationDefaultWithRule / override swap_negation
Sections closed with an exit token (exit, quit, end-*)?SectionalExitingRule / override sectional_exit
Last-write-wins commands (hostname, description, …)?IdempotentCommandsRule
Comment/banner lines to strip on load?PerLineSubRule / FullTextSubRule
Blocks with irregular indentation?IndentAdjustRule
Flat set/delete syntax (Junos-like)?config_preprocessor + declaration_prefix (see platforms/vyos/driver.py)
Order-sensitive commands?OrderingRule with weights

Reference implementations: platforms/huawei_vrp/driver.py (small, rule-based), platforms/vyos/driver.py (preprocessor-based), platforms/cisco_ios/driver.py (comprehensive).

Step 2: Write the Failing Test First (TDD)

Create tests/test_driver_<platform>.py before the driver exists — conventions in docs/dev/testing.md. Flat functions, full annotations, round-trip idiom:

python
from hier_config import Platform, get_hconfig_fast_load


def test_negation_prefix() -> None:
    running_config = get_hconfig_fast_load(
        Platform.ACME_OS, ("interface eth0", "  shutdown")
    )
    generated_config = get_hconfig_fast_load(
        Platform.ACME_OS, ("interface eth0",)
    )
    remediation = running_config.config_to_get_to(generated_config)
    assert remediation.dump_simple() == ("interface eth0", "  no shutdown")

    running_after = running_config.future(remediation)
    rollback = running_after.config_to_get_to(running_config)
    running_after_rollback = running_after.future(rollback)
    assert not tuple(running_config.unified_diff(running_after_rollback))

Run it and confirm it fails for the right reason (unknown platform), not an import error. Add realistic config fixtures to tests/fixtures/ if tests need more than inline tuples.

Show full SKILL.md (174 more words)Show less

Step 3: Scaffold the Driver

Create hier_config/platforms/<platform>/__init__.py (empty) and hier_config/platforms/<platform>/driver.py:

python
from hier_config.models import IdempotentCommandsRule, MatchRule, PerLineSubRule
from hier_config.platforms.driver_base import HConfigDriverBase, HConfigDriverRules


class HConfigDriverAcmeOS(HConfigDriverBase):
    """Driver for Acme OS.

    Platform enum: ``Platform.ACME_OS``.
    """

    @staticmethod
    def _instantiate_rules() -> HConfigDriverRules:
        return HConfigDriverRules(
            idempotent_commands=[
                IdempotentCommandsRule(match_rules=(MatchRule(startswith="hostname "),)),
            ],
            per_line_sub=[
                PerLineSubRule(search="^\\s*#.*", replace=""),
            ],
        )

Replace # in the per_line_sub regex with the platform's actual comment token, and keep the ^\s* anchor so indented comments are stripped too. Rules take match_rules: tuple[MatchRule, ...] (immutable — never lists). A minimal driver returning bare HConfigDriverRules() is valid; only add rules the platform needs. Public classes require docstrings.

Step 4: Register the Platform

  1. Add the member to the Platform enum in hier_config/models.py (alphabetical position). Note the enum uses auto(), so inserting a member renumbers everything after it — fine for in-repo use, but never rely on Platform.value for serialization.
  2. Add the mapping to the platform_drivers dict in get_hconfig_driver (hier_config/constructors.py) and import the driver class there.

Step 5: Document and Log

  • Add a driver section (behavior summary + activation snippet) and a platform-table row to docs/user/drivers.md. Mark the status Experimental for a new driver.
  • Add a CHANGELOG.md entry under ## [Unreleased] → ### Added.

Step 6: Run the Gates

bash
poetry run pytest tests/test_driver_<platform>.py -v
poetry run ./scripts/build.py lint-and-test
poetry run mkdocs build --strict

All three must pass (mypy/pyright are strict; coverage floor is 95%). Then run the hier-config-review skill before opening the PR.

© netdevops, MIT. 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 .claude/skills/hier-config-new-driver of netdevops/hier_config.

Open the folder on GitHubat commit 806c654

Compare with similar skills

Hier Config New Driver 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.

Hier Config New Driver compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hier Config New Driver this skillnetdevops/hier_config150—~1.3kAutomated safety check: PassMIT
Gapgraph-robots/graph-as-policy155—~3.3kAutomated safety check: PassMIT
Nodejs CLI Best Practiceslirantal/nodejs-cli-apps-best-practices4.1k—~2kAutomated safety check: PassCC-BY-SA-4.0
Scaffoldcodewithmukesh/dotnet-claude-kit751—~1.7kAutomated safety check: PassMIT
Codegen TransformComfy-Org/ComfyUI_frontend2.1k—~2kAutomated safety check: PassGPL-3.0
Core PR Helpercalimero-network/core171—~614Automated safety check: PassCustom licence

Similar skills

  • Gap

    graph-robots/graph-as-policy

    Program robots with GaP (graph-as-policy) — compile natural-language tasks into typed, verified robot skill graphs and run them on simulators or real robots.

    155 GitHub stars~3.3k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Nodejs CLI Best Practices

    lirantal/nodejs-cli-apps-best-practices

    Guide and audit Node.js CLI application development against 41 established best practices covering UX, distribution, interoperability, accessibility, testing, error handling, development setup…

    4.1k GitHub stars~2k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Scaffold

    codewithmukesh/dotnet-claude-kit

    Architecture-aware feature scaffolding for .NET 10 projects.

    751 GitHub stars~1.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Codegen Transform

    Comfy-Org/ComfyUI_frontend

    Transforms raw Playwright codegen output into ComfyUI convention-compliant tests.

    2.1k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Core PR Helper

    calimero-network/core

    Suggests one appropriate branch name and a PR description in the project template (title, Description, Test plan, Documentation update) for Calimero core.

    171 GitHub stars~614 tokensUpdated today
    DevelopmentAuto-check passed
  • Scaffolds and reviews `Git::Commands::*` classes in the ruby-git library, with unit tests, integration tests and YARD docs, using the Base command architecture.

    1.8k GitHub stars~3k tokensUpdated 6 days ago
    DevelopmentAuto-check passed

More from netdevops/hier_config

  • Hier Config Review

    netdevops/hier_config

    A skill your agent uses when asked to review changes, self-review work, or prepare a pull request in the hierconfig repository — especially before opening or updating a PR, or when checking…

    150 GitHub stars~903 tokensUpdated 16 days ago
    Auto-check passed
  • Hier Config Troubleshoot

    netdevops/hier_config

    A skill your agent uses when hierconfig produces wrong or unexpected output — incorrect remediation commands, missing or extra negations, repeated commands, lines nested under the wrong parent…

    150 GitHub stars~1.4k tokensUpdated 16 days ago
    Auto-check passed

Questions about Hier Config New Driver

What does Hier Config New Driver do?

A skill your agent uses when adding hierconfig support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver…. Hier Config New Driver is an agent skill from netdevops/hier_config. Use when adding hierconfig support for a new network platform or operating system — creating a platform driver, registering a new Platform enum member, or scaffolding driver rules and tests for an unsupported vendor.

When should I use Hier Config New Driver?

Hier Config New Driver fits situations like: adding hierconfig support for a new network platform; operating system — creating a platform driver; registering a new Platform enum member; scaffolding driver rules and tests for an unsupported vendor.

How do I install Hier Config New Driver in Claude Code?

Run `npx skills add netdevops/hier_config --skill hier-config-new-driver -a claude-code`. Or copy the skill folder (.claude/skills/hier-config-new-driver in netdevops/hier_config) into .claude/skills/hier-config-new-driver in your project. Claude Code loads it when a task matches its description.

How do I install Hier Config New Driver in Codex?

Run `npx skills add netdevops/hier_config --skill hier-config-new-driver -a codex`. Or copy the skill folder (.claude/skills/hier-config-new-driver in netdevops/hier_config) into .agents/skills/hier-config-new-driver in your project. Codex loads it when a task matches its description.

Can I use Hier Config New Driver 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 netdevops/hier_config --skill hier-config-new-driver -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hier-config-new-driver, .gemini/skills/hier-config-new-driver, .github/skills/hier-config-new-driver and .opencode/skills/hier-config-new-driver in your project.

What does Hier Config New Driver need to run?

Going by SKILL.md and its folder, Hier Config New Driver needs the command-line tools its instructions call (poetry). Our summary lists: Python 3.

Does Hier Config New Driver access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hier Config New Driver 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 Hier Config New Driver use?

Hier Config New Driver is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hier Config New Driver use?

About 1.3k tokens (SKILL.md is roughly 5k 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 Hier Config New Driver?

Skills that share tags, products or a category with Hier Config New Driver: Gap (graph-robots/graph-as-policy, 155 stars), Nodejs CLI Best Practices (lirantal/nodejs-cli-apps-best-practices, 4.1k stars), Scaffold (codewithmukesh/dotnet-claude-kit, 751 stars) and Codegen Transform (Comfy-Org/ComfyUI_frontend, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hier Config New Driver?

netdevops (a GitHub organization) maintains it in netdevops/hier_config, which has 150 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 21, 2026.

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