Stats
Actions
Tags
From project-toolkit
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.
How this skill is triggered — by the user, by Claude, or both
Slash command
/project-toolkit:taste-lintsclaude-sonnet-4-6The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Custom lints where error messages become agent-readable remediation instructions.
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
npx claudepluginhub rjmurillo/ai-agents --plugin project-toolkitRuns 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.
Indexes pedantic-coder skills for universal code quality principles including naming precision, casing law, import discipline, declaration order, symmetry, and dead code intolerance. Use for code reviews, refactoring, or greenfield projects.
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.