harness-authoring

Guides authoring of SKILL.md files and subagents with context budget discipline.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-authoring-zhengguangli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-authoring
Source: https://github.com/zhengguangli/harness-engineering-kit/tree/main/skills/harness-authoring
Command: npx skills add https://github.com/zhengguangli/harness-engineering-kit --skill harness-authoring-zhengguangli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams extending an agent harness system often write bloated, overlapping, or mis-scoped skills and subagents that waste context budget and cause false triggers. This Skill provides the methodology, decision rules, and scaffolding templates to author new skills and subagents correctly. ## Core Features & Use Cases - Skill vs. Subagent Decision Framework: Provides comparison tables and a quick decision matrix to decide whether a capability should be a context-injected skill or an isolated-execution subagent. - Context Budget Discipline: Enforces a three-tier loading mechanism (resident metadata, triggered body under 500 lines, on-demand references) with concrete splitting strategies. - Scaffolding & Quality Gates: Ships scaffold templates, design pattern references, and an automated check script that validates structure, reference files, and required sections. - Use Case: When a user asks "should this be a skill or a subagent" or wants to slim a SKILL.md that has grown past 500 lines, this Skill routes the decision, extracts complete sections into references/ files, and updates navigation pointers. ## Quick Start Ask the agent to scaffold a new harness skill named "deploy-checker" following the harness-authoring conventions and check it for overlap with existing skills.

Frequently Asked Questions about harness-authoring

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

FAQPage Schema
How do I write a good SKILL.md file for Claude Code?▼

Write the description first with both what it does and when to use it, keep the body under 500 lines, and split excess content into references/ sub-files. Declare depends_on in frontmatter and include a canonical Agent prompt section with skip conditions.

Should I create a skill or a subagent for a new capability?▼

Use a skill when the main conversation needs to retain the knowledge across turns; use a subagent when the task can execute independently and only return a summary. Skills consume the main context budget, while subagents run in isolated context windows.

How do I slim down a SKILL.md that exceeds 500 lines?▼

Identify complete topic sections and move them into references/ sub-files, then add loading instructions in the body stating when to read each file. Each reference file should cover one unified topic so the agent loads only what it needs.

What tool permissions should a read-only subagent have?▼

Read-only agents should receive only Read, Grep, Glob, and read-only Bash commands, never Edit or Write. Omitting the tools field inherits all tools, which violates the least-privilege principle.

How do I check if a new skill overlaps with existing ones?▼

Scan the skills/ directory with Grep and Glob, searching file names and verb phrases in description fields for synonym combinations. If overlap exceeds 50 percent, merge into the stronger skill; otherwise define explicit boundaries in both skills.