skill-token-budget-linter

skill-token-budget-linter143 wordsMITv1.0.0Repo-owned

skill-token-budget-linter

Lint skill descriptions, body length, and reference bulk against token budgets. Use when tightening standing-context cost. NOT for DCP tuning or RTK hooks.

Quick Start

Install:

npx skills add github:wyattowalsh/agents --skill skill-token-budget-linter -y -g --agent antigravity --agent claude-code --agent codex --agent crush --agent cursor --agent gemini-cli --agent github-copilot --agent grok --agent opencode

Use: /skill-token-budget-linter <skill-name|repo> [--strict]

Works with Claude Code, Gemini CLI, OpenCode, and other agentskills.io-compatible agents.

Source & provenance

This page is generated from the repository file skills/skill-token-budget-linter/SKILL.md by wagents docs generate.

What It Does

Measure standing-context pressure for skill assets before they ship.

Modes

$ARGUMENTS	Action
<name>	Lint one skill directory
repo / --all	Lint every skills/*/SKILL.md
--strict	Fail on warning-tier budgets, not just hard limits
Empty	Show budget table and example commands

Public Metadata

Field	Value
Source Type	repo-owned
Display Source	github:wyattowalsh/agents
Source Kind	repo
Installability	portable command
Review State	reviewed
Target Agents	antigravity, claude-code, codex, crush, cursor, gemini-cli, github-copilot, grok, opencode

General

Field	Value
Name	skill-token-budget-linter
License	MIT
Version	1.0.0
Author	wyattowalsh

Claude Code

Field	Value
Argument Hint	`[skill-name

Used By

prompt-optimizerScaffold for prompt/token optimization reviews on agent and skill bodies (planned).

View Full SKILL.md

---
name: skill-token-budget-linter
description: >-
  Lint skill descriptions, body length, and reference bulk against token budgets.
  Use when tightening standing-context cost. NOT for DCP tuning or RTK hooks.
user-invocable: true
argument-hint: "<skill-name|repo> [--strict]"
license: MIT
metadata:
  author: wyattowalsh
  version: "1.0.0"
---

# Skill Token Budget Linter

Measure standing-context pressure for skill assets before they ship.

**Scope:** Static token-budget linting only. Does not change OpenCode DCP, RTK, or harness hook policy.

## Dispatch

| $ARGUMENTS | Action |
|------------|--------|
| `<name>` | Lint one skill directory |
| `repo` / `--all` | Lint every `skills/*/SKILL.md` |
| `--strict` | Fail on warning-tier budgets, not just hard limits |
| Empty | Show budget table and example commands |

## Budget Table

| Surface | Soft warn | Hard fail |
|---------|-----------|-----------|
| `description` | 200 chars | 1024 chars |
| body (below frontmatter) | 400 lines | 500 lines |
| single reference file | 300 lines | 500 lines |

## Workflow

```bash
uv run python skills/skill-token-budget-linter/scripts/lint_budget.py <name>
uv run python skills/skill-token-budget-linter/scripts/lint_budget.py --all
```

## Validation Contract

```bash
uv run python skills/skill-token-budget-linter/scripts/check.py
```

Download from GitHub

Resources

Skill CatalogBrowse custom and external skills.

CLI ReferenceInstall and manage skills.

agentskills.ioThe open ecosystem for cross-agent skills.

---

View source on GitHub