agent-kit-extend

Guides overriding and extending laid-out coding rules with section merges, gate branches, and guard profiles.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill agent-kit-extend-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-kit-extend
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/agent-kit-extend
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill agent-kit-extend-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a repository lays out a shared rules package, the shipped text, gate mappings, and guard checks often do not match the tree's own names, paths, and conventions. Editing laid-out files in place is silently lost on the next sync, so teams need a safe, repeatable way to layer their own overrides, gate branches, guard profiles, and custom rules on top of the package. ## Core Features & Use Cases - Section-based text overrides: Place override files under overrides/ that merge by heading — replacing, appending, or lifting package sections — with guidance on pitfalls like headings inside code fences. - Gate and guard customization: Add your own skill_for branches and profile functions (docs pairing, lint targets, branch forms) that run before the package default while still delegating to _default. - Signs, checks, and custom laws: Declare uniformity signals as mergeable JSON data, and author your own laws and rules linked through frontmatter with a consistency audit. - Use Case: A repo's gate demands the wrong rule for *.stories.ts files. Add a specific branch before the general one in skill_for, call skill_for_default for everything else, then verify with the package gate scenarios and sync --check. ## Quick Start Ask the assistant to add an override for the package rule file whose text does not match this repository, then run sync and sync --check to verify the layout.

Frequently Asked Questions about agent-kit-extend

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I override a rule file from a laid-out rules package?

Create a file under overrides/ whose path mirrors the resource path, such as overrides/rules/testing.md. Sections merge by heading: matching headings replace the package section in full, new headings are appended, and empty bodies lift the package section.

How do I add a custom gate branch for specific file types?

Redefine the skill_for shell function with your specific case patterns placed before general ones, since the first match wins. Always call skill_for_default at the end so the package's built-in branches keep working.

Why did my override not replace the package section?

Headings inside code fences are ignored by the parser, so an override named by such a heading is appended as a new section instead of replacing anything. List real section headings with an awk command that skips fenced blocks before writing the override.

What happens if I edit a laid-out file in place?

Laid-out files carry a version and checksum header, so in-place edits are lost on the next layout and sync refuses the modified file instead of overwriting it silently. Always express changes as overrides or config, then run sync.

How are uniformity signal configs merged with the package defaults?

Objects merge key by key, so naming one key does not lose its neighbours. Lists are replaced in full, so a list like sourceRoots must always be written completely rather than treated as an addition.

Why does the guard reject edits after I changed a shell profile function?

A pattern replacement can break shell syntax, such as losing an esac from a case statement, causing the guard to exit non-zero and refuse the edit. Run bash -n on the file after editing to catch syntax errors.