From copilot-cli-toolkit
Runs custom Python lints enforcing taste invariants like file size limits, naming conventions (snake_case Python, kebab-case YAML), function complexity, with agent-readable remediation instructions. Use when writing or reviewing code.
npx claudepluginhub rjmurillo/ai-agentsThis skill uses the workspace's default tool permissions.
Custom lints where error messages become agent-readable remediation instructions.
Enforces custom lints for file size limits, naming conventions (snake_case Python, kebab-case YAML/skills, PascalCase PowerShell), function complexity, and skill size with agent-readable remediation instructions. Use when writing, reviewing, or preparing code for PRs.
Automates format-lint-resolve pipelines for code editing tasks. Discovers linters from pyproject.toml/.pre-commit-config.yaml/package.json, fixes ruff/mypy/bandit issues, ensures quality before completion.
Lints coding agent instruction files (CLAUDE.md, .cursorrules, AGENTS.md) for vagueness, conflicts, redundancies, ordering issues, misplaced rules, weak emphasis, and token budget. Provides ratings, gap detection, and consolidations.
Share bugs, ideas, or general feedback.
Custom lints where error messages become agent-readable remediation instructions.
Inspired by OpenAI Harness Engineering:
"We statically enforce structured logging, naming conventions for schemas and types, file size limits, and platform-specific reliability requirements with custom lints. Because the lints are custom, we write the error messages to inject remediation instructions into agent context."
| Trigger Phrase | Operation |
|---|---|
run taste lints | taste_lints.py on staged or specified files |
check file size | taste_lints.py with file-size rule only |
check naming conventions | taste_lints.py with naming rule only |
lint taste invariants | taste_lints.py full scan |
taste lint report | taste_lints.py with JSON output |
Use this skill when:
Files exceeding line thresholds indicate poor cohesion.
| Threshold | Lines | Severity |
|---|---|---|
| Warning | 301-500 | warning |
| Error | 501+ | error |
| Pattern | Rule | Applies To |
|---|---|---|
snake_case | Python files, functions, variables | *.py |
kebab-case | Skill directories, YAML files | .claude/skills/, *.yml |
PascalCase | PowerShell functions, classes | *.ps1, *.psm1 |
UPPER_CASE | Constants, environment variables | All languages |
invoke_ prefix | Hook scripts | .claude/hooks/ |
Functions exceeding cyclomatic complexity 10 need decomposition.
Skills exceeding 500 lines need progressive disclosure refactoring.
python3 .claude/skills/taste-lints/scripts/taste_lints.py with target files# Scan staged files
python3 .claude/skills/taste-lints/scripts/taste_lints.py --git-staged
# Scan specific files
python3 .claude/skills/taste-lints/scripts/taste_lints.py path/to/file.py
# Scan a directory
python3 .claude/skills/taste-lints/scripts/taste_lints.py --directory src/
# JSON output
python3 .claude/skills/taste-lints/scripts/taste_lints.py --format json --git-staged
# Run specific rules only
python3 .claude/skills/taste-lints/scripts/taste_lints.py --rules file-size,naming
| Code | Meaning |
|---|---|
| 0 | No violations found |
| 1 | Script error (bad arguments, file not found) |
| 10 | Violations detected |
Add a comment to suppress a specific rule on a file:
# taste-lint: ignore file-size
Valid rules: file-size, naming, complexity, skill-size