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

v1.0.0
GitHub

À propos de ce 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

Pourquoi utiliser cette compétence

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.

Meilleur pour

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

↓ Cas d'utilisation exploitables 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

! Sécurité et Limitations

  • 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 supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.

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.

Imported Repository Instructions

The section below is supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.

Supporting Evidence

golden-principles

Install golden-principles, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly
Imported Repository Instructions
The section below is supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.
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

Compétences associées

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

Voir tout

openclaw-release-maintainer

Logo of openclaw
openclaw

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

★ 333.8k
⑂ 0
Intelligence artificielle

widget-generator

Logo of f
f

Générez des plugins de widgets personnalisables pour le système de flux prompts.chat

★ 149.6k
⑂ 0
Intelligence artificielle

flags

Logo of vercel
vercel

Le Cadre de Réaction

★ 138.4k
⑂ 0
Navigateur

pr-review

Logo of pytorch
pytorch

Tenseurs et réseaux neuronaux dynamiques en Python avec une forte accélération GPU

★ 98.6k
⑂ 0
Développeur