The 10 agent-first operating principles governing how agents work in this repository. USE FOR: agent behavior rules, operating philosophy, principle lookup, governance invariants. DO NOT USE FOR: Azure infrastructure, code generation, troubleshooting, diagram creation.
79
73%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/golden-principles/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description excels at completeness and distinctiveness through its USE FOR / DO NOT USE structure, which provides clear positive and negative trigger guidance. The main weakness is in specificity — it describes what the skill contains (principles) rather than listing concrete actions the skill performs. The trigger terms are well-chosen and natural.
Suggestions
Add concrete actions the skill performs, e.g., 'Lists, explains, and checks compliance against the 10 agent-first operating principles' rather than just describing what the principles are.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain ('agent-first operating principles') and some actions ('principle lookup, governance invariants'), but the actual capabilities are abstract — it describes what the skill contains rather than concrete actions it performs like 'list principles', 'explain a specific principle', or 'check compliance against principles'. | 2 / 3 |
Completeness | Clearly answers both 'what' (the 10 agent-first operating principles governing agent behavior) and 'when' (USE FOR clause with explicit triggers, plus a DO NOT USE clause for negative triggers). The explicit USE FOR / DO NOT USE structure serves as strong trigger guidance. | 3 / 3 |
Trigger Term Quality | Good coverage of natural trigger terms: 'agent behavior rules', 'operating philosophy', 'principle lookup', 'governance invariants'. The DO NOT USE clause also helps prevent false matches with terms like 'Azure infrastructure', 'code generation', 'troubleshooting', 'diagram creation'. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche — operating principles and governance invariants for agents. The explicit DO NOT USE clause further reduces conflict risk by ruling out common adjacent domains like Azure infrastructure and code generation. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized governance skill that clearly articulates 10 operating principles with testable criteria for each. Its main strengths are excellent progressive disclosure and clear structure with the 'Test' blocks providing concrete verification. Its weaknesses are moderate verbosity (some principles overlap, e.g., 2 and 9) and limited actionability since it provides philosophical guidance rather than executable commands, though this is partially justified by the skill's nature as a governance document.
Suggestions
Consolidate Principles 2 and 9 which substantially overlap (both about progressive disclosure and pointing to deeper docs) to reduce redundancy and improve conciseness.
Add concrete examples or commands where possible, e.g., for Principle 10 show an actual linter rule example, or for Principle 1 show the exact directory structure expected in agent-output/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably well-structured but includes some redundancy. The 'How to Apply These Principles' section partially restates what the principles already convey. The 'Test' blocks add value but some principles could be tighter (e.g., Principle 9 largely restates Principle 2). Overall mostly efficient but not maximally lean. | 2 / 3 |
Actionability | Each principle includes a concrete 'Test' question which provides actionable verification criteria, and the 'How to Apply' section gives specific guidance for different roles. However, there are no executable code examples or commands — the guidance is directional rather than copy-paste ready. For a governance/philosophy skill this is acceptable but still lacks concrete artifacts like example ADR templates or validation commands. | 2 / 3 |
Workflow Clarity | The 'How to Apply' section provides sequenced guidance (read this first, then azure-defaults, etc.) and the progressive loading order is mentioned in Principle 8. However, there are no explicit validation checkpoints or feedback loops for applying the principles. For a governance skill this is adequate but the workflow for principle enforcement is implicit rather than explicit. | 2 / 3 |
Progressive Disclosure | The skill practices what it preaches — it serves as an overview with clear pointers to deeper sources (azure-defaults skill, azure-artifacts templates, AGENTS.md, scripts/validate-artifacts.mjs). References are one level deep and well-signaled. The content is appropriately scoped as a principles overview without inlining detailed implementation guidance. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
ec7b8ff
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.