GO

golden-principles

Scans and enforces organizational golden principles within a repository.

Install

mkdir -p .claude/skills/golden-principles && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14603" && unzip -o skill.zip -d .claude/skills/golden-principles && rm skill.zip

Installs to .claude/skills/golden-principles

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Scan repository for golden principle violations with agent-readable remediation. Enforces GP-001 through GP-008 from .agents/governance/golden-principles.md. Use when auditing compliance, preparing PRs, or running garbage collection scans.
239 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • →Scan the repository for violations of golden principles GP-001 through GP-008.
  • →Produce remediation instructions for identified violations.
  • →Scope scans to the entire repository, specific directories, or PR diffs.
  • →Run specific rules only, such as `script-language` or `skill-frontmatter`.
  • →Output results in JSON format for tooling integration.

How it works

The skill executes a Python script to scan specified targets for violations of predefined golden principles and generates remediation advice.

Inputs & outputs

You give it
A target for scanning (repository, directory, or diff scope) and optional rules/format.
You get back
A report of golden principle violations with agent-readable remediation instructions, optionally in JSON format.

When to use golden-principles

  • →Auditing principle compliance
  • →Preparing code for PR submission
  • →Garbage collection scans

About golden-principles

Performs mechanical scans of the codebase to identify violations of predefined golden principles and provides actionable remediation paths.

Scan repository for golden principle violations with agent-readable remediation. Enforces GP-001 through GP-008 from .agents/governance/golden-principles.md. Use when auditing compliance, preparing PRs, or running garbage collection scans.

When not to use it

  • →When checking code-level invariants only like file size or naming.
  • →When grading domains across architectural layers.
  • →When producing quality trend reports.

Limitations

  • →The skill enforces GP-001 through GP-008 as defined in `.agents/governance/golden-principles.md`.
  • →The skill requires a Python script to run the scan.
  • →The skill can be suppressed for specific rules via file header comments.

How it compares

This workflow mechanically enforces specific golden principles and provides agent-readable remediation, unlike general linting or quality grading tools.

Compared to similar skills

golden-principles side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
golden-principles (this skill)04moReviewIntermediate
pair-capability-verify-adoption08moNo flagsIntermediate
harness-boundary06moNo flagsAdvanced
adversarial-review06moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry