CtrlK
BlogDocsLog inGet started
Tessl Logo

golden-principles

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

Quality

73%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/golden-principles/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
Reviewed

Table of Contents

Is this your skill?

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.