golden-principles — agentic-ai golden-principles, ai-agents, community, agentic-ai, ide skills, ai-assistant, anthropic-claude, claude-code, code-generation, code-review

v1.0.0
GitHub

Sobre este Skill

Perfect for Code Analysis Agents needing automated golden principle compliance scans and remediation instructions. Multi-agent system for software development

# Core Topics

agentic-ai ai-agents ai-assistant anthropic-claude claude-code code-generation
rjmurillo rjmurillo
[15]
[4]
Updated: 3/31/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 9/11

This page remains useful for operators, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Quality floor passed for review
Review Score
9/11
Quality Score
60
Canonical Locale
en
Detected Body Locale
en

Perfect for Code Analysis Agents needing automated golden principle compliance scans and remediation instructions. Multi-agent system for software development

Por que usar essa habilidade

Empowers agents to enforce mechanically enforced golden principles directly into the repository, utilizing Python scripts and JSON output for tooling, and providing remediation instructions for violations of rules such as script-language, skill-frontmatter, and yaml-logic.

Melhor para

Perfect for Code Analysis Agents needing automated golden principle compliance scans and remediation instructions.

↓ Casos de Uso Práticos for golden-principles

Automating periodic garbage collection scans for repository compliance
Debugging golden principle violations in specific directories or files
Generating JSON reports for tooling and auditing purposes

! Segurança e Limitações

  • Requires Python 3 execution environment
  • Limited to scanning repositories for specific golden principle rules
  • Needs write access to the repository for remediation instructions

Why this page is reference-only

  • - Current locale does not satisfy the locale-governance contract.

Source Boundary

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

After The Review

Decide The Next Action Before You Keep Reading Repository Material

Killer-Skills should not stop at opening repository instructions. It should help you decide whether to install this skill, when to cross-check against trusted collections, and when to move into workflow rollout.

Install Path

Start With Installation And Validation

If this skill is worth continuing with, the next step is to confirm the install command, CLI write path, and environment validation.
Trusted Recheck

Cross-Check Against Trusted Picks

If you are still comparing multiple skills or vendors, go back to the trusted collection before amplifying repository noise.
Workflow

Move To Workflow Collections For Team Rollout

When the goal shifts from a single skill to team handoff, approvals, and repeatable execution, move into workflow collections.
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is golden-principles?

Perfect for Code Analysis Agents needing automated golden principle compliance scans and remediation instructions. Multi-agent system for software development

How do I install golden-principles?

Run the command: npx killer-skills add rjmurillo/ai-agents/golden-principles. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for golden-principles?

Key use cases include: Automating periodic garbage collection scans for repository compliance, Debugging golden principle violations in specific directories or files, Generating JSON reports for tooling and auditing purposes.

Which IDEs are compatible with golden-principles?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for golden-principles?

Requires Python 3 execution environment. Limited to scanning repositories for specific golden principle rules. Needs write access to the repository for remediation instructions.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add rjmurillo/ai-agents/golden-principles. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use golden-principles immediately in the current project.

! Reference-Only Mode

This page remains useful for installation and reference, but Killer-Skills no longer treats it as a primary indexable landing page. Read the review above before relying on the upstream repository instructions.

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Upstream Source

golden-principles

Install golden-principles, an AI agent skill for AI agent workflows and automation. Review the use cases, limitations, and setup path before rollout.

SKILL.md
Readonly
Upstream Repository Material
The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.
Supporting Evidence

Golden Principles

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."

Triggers

Trigger PhraseOperation
scan golden principlesFull principle compliance scan
check principle complianceScan with summary report
golden principle violationsScan and list violations
run garbage collectionDeep scan with fix-up recommendations
audit principlesScan specific rules only

When to Use

Use this skill when:

  • Preparing a PR for submission (catch violations early)
  • Running periodic garbage collection scans
  • Auditing a domain or directory for compliance
  • Adding new files to the repository

Use taste-lints instead when:

  • Checking code-level invariants only (file size, naming, complexity)
  • Running pre-commit checks on staged files

Use quality-grades instead when:

  • Grading domains across architectural layers
  • Producing quality trend reports

Process

  1. Run python3 .claude/skills/golden-principles/scripts/scan_principles.py with target
  2. Review AGENT_REMEDIATION blocks in output
  3. Apply suggested fixes
  4. Re-run to confirm compliance

Usage

bash
1# Scan entire repository
2python3 .claude/skills/golden-principles/scripts/scan_principles.py
3
4# Scan specific directory
5python3 .claude/skills/golden-principles/scripts/scan_principles.py --directory .claude/skills/
6
7# Run specific rules only
8python3 .claude/skills/golden-principles/scripts/scan_principles.py --rules script-language,skill-frontmatter
9
10# JSON output for tooling
11python3 .claude/skills/golden-principles/scripts/scan_principles.py --format json
12
13# Write results to file
14python3 .claude/skills/golden-principles/scripts/scan_principles.py --output scan-results.json --format json

Rules

RulePrincipleWhat it checks
script-languageGP-001No new .sh/.bash files
skill-frontmatterGP-003SKILL.md has required frontmatter fields
agent-definitionGP-004Agent .md files have required sections
yaml-logicGP-005No inline logic in workflow YAML
actions-pinnedGP-006GitHub Actions pinned to SHA

GP-002, GP-007, GP-008 are enforced by existing tools (git hooks, taste-lints).

Exit Codes

CodeMeaning
0No violations found
1Script error (bad arguments, file not found)
10Violations detected

Suppression

Add a comment in the file header to suppress a specific rule:

python
1# golden-principle: ignore script-language

Valid rules: script-language, skill-frontmatter, agent-definition, yaml-logic, actions-pinned

Verification

After execution:

  • Report lists scanned file count
  • Each violation includes principle ID and remediation
  • Exit code matches violation state
  • Output format matches --format flag

Cross-References

Habilidades Relacionadas

Looking for an alternative to golden-principles or another community skill for your workflow? Explore these related open-source skills.

Ver tudo

openclaw-release-maintainer

Logo of openclaw
openclaw

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

★ 333.8k
⑂ 0
Inteligência Artificial

widget-generator

Logo of f
f

Gerar plugins de widgets personalizáveis para o sistema de feed do prompts.chat

★ 149.6k
⑂ 0
Inteligência Artificial

flags

Logo of vercel
vercel

O Framework React

★ 138.4k
⑂ 0
Navegador

pr-review

Logo of pytorch
pytorch

Tensors and Dynamic neural networks in Python with strong GPU acceleration

★ 98.6k
⑂ 0
Desenvolvedor