From project-toolkit
Scans repository for golden principle violations (GP-001 to GP-008) with agent-readable remediation instructions. Use for compliance audits, PR preparation, or garbage collection scans.
npx claudepluginhub rjmurillo/ai-agents --plugin project-toolkitThis skill uses the workspace's default tool permissions.
Scan the repository for violations of mechanically enforced golden principles.
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Scan the repository for violations of mechanically enforced golden principles. Produces remediation instructions that agents can act on directly.
Inspired by OpenAI Harness Engineering:
"We started encoding what we call 'golden principles' directly into the repository and built a recurring cleanup process."
| Trigger Phrase | Operation |
|---|---|
scan golden principles | Full principle compliance scan |
check principle compliance | Scan with summary report |
golden principle violations | Scan and list violations |
run garbage collection | Deep scan with fix-up recommendations |
audit principles | Scan specific rules only |
Use this skill when:
Use taste-lints instead when:
Use quality-grades instead when:
python3 .claude/skills/golden-principles/scripts/scan_principles.py with target# Scan entire repository
python3 .claude/skills/golden-principles/scripts/scan_principles.py
# Scan specific directory
python3 .claude/skills/golden-principles/scripts/scan_principles.py --directory .claude/skills/
# Run specific rules only
python3 .claude/skills/golden-principles/scripts/scan_principles.py --rules script-language,skill-frontmatter
# JSON output for tooling
python3 .claude/skills/golden-principles/scripts/scan_principles.py --format json
# Write results to file
python3 .claude/skills/golden-principles/scripts/scan_principles.py --output scan-results.json --format json
| Rule | Principle | What it checks |
|---|---|---|
script-language | GP-001 | No new .sh/.bash files |
skill-frontmatter | GP-003 | SKILL.md has required frontmatter fields |
agent-definition | GP-004 | Agent .md files have required sections |
yaml-logic | GP-005 | No inline logic in workflow YAML |
actions-pinned | GP-006 | GitHub Actions pinned to SHA |
GP-002, GP-007, GP-008 are enforced by existing tools (git hooks, taste-lints).
| Code | Meaning |
|---|---|
| 0 | No violations found |
| 1 | Script error (bad arguments, file not found) |
| 10 | Violations detected |
Add a comment in the file header to suppress a specific rule:
# golden-principle: ignore script-language
Valid rules: script-language, skill-frontmatter, agent-definition, yaml-logic, actions-pinned
After execution: