CtrlK
BlogDocsLog inGet started
Tessl Logo

golden-principles

**ANALYSIS SKILL** — The agent-first operating principles governing how agents work in this repository. WHEN: "golden principles", "agent behavior rules", "operating philosophy", "principle lookup", "governance invariants". USE FOR: agent behavior rules, operating philosophy, principle lookup, governance invariants. DO NOT USE FOR: Azure infrastructure, code generation, troubleshooting, diagram creation.

58

Quality

66%

Does it follow best practices?

Impact

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

75%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has strong structural completeness with explicit WHEN, USE FOR, and DO NOT USE FOR clauses, making it well-organized for skill selection. Its main weakness is that it describes a conceptual domain rather than concrete actions — it tells you what the skill *covers* but not what it *does* (e.g., 'retrieves', 'enforces', 'validates'). The trigger terms lean toward internal jargon rather than natural user language.

Suggestions

Add concrete action verbs describing what the skill does, e.g., 'Retrieves and explains the golden principles governing agent behavior' or 'Validates agent actions against repository governance rules'.

Include more natural-language trigger terms that users might actually say, such as 'how should agents behave', 'what are the rules for agents', 'agent guidelines', or 'repository principles'.

DimensionReasoningScore

Specificity

The description names a domain ('agent-first operating principles') and some actions ('principle lookup', 'governance invariants'), but the actual concrete actions are vague — it describes what the skill *is about* rather than what it *does*. There are no specific verbs like 'extract', 'analyze', or 'generate'.

2 / 3

Completeness

The description explicitly answers both 'what' (operating principles governing how agents work) and 'when' (with a clear WHEN clause listing trigger terms, a USE FOR clause, and notably a DO NOT USE FOR clause that helps with disambiguation). This is a well-structured completeness pattern.

3 / 3

Trigger Term Quality

It includes some relevant keywords like 'golden principles', 'agent behavior rules', 'operating philosophy', and 'governance invariants', but these are fairly niche/jargon-heavy terms. A user is more likely to ask about 'how agents should behave' or 'repository guidelines' than 'governance invariants' or 'principle lookup'.

2 / 3

Distinctiveness Conflict Risk

The description is clearly distinguishable from other skills thanks to its specific niche ('agent-first operating principles') and the explicit DO NOT USE FOR clause that rules out Azure infrastructure, code generation, troubleshooting, and diagram creation, significantly reducing conflict risk.

3 / 3

Total

10

/

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/philosophy skill that effectively uses progressive disclosure to keep the overview lean while pointing to detailed references. Its main weakness is that the body itself lacks concrete, actionable examples of how to apply any specific principle — it's more of a table of contents than an instructional guide. The workflow steps are present but could benefit from explicit validation checkpoints.

Suggestions

Add at least one concrete example showing how a principle is applied to a real design decision (e.g., 'When adding a new module, Principle 4 means: validate all input variables with `validation {}` blocks at the module boundary').

Add a feedback loop to the Steps workflow, e.g., 'If the per-principle test fails, identify which principle is violated, adjust the design, and re-run the test before proceeding.'

DimensionReasoningScore

Conciseness

The content is reasonably efficient but includes some redundancy — the numbered list of principles appears as a summary, then is referenced again in 'The 10 Principles' section which itself just points to a reference file. The preamble sentences explaining what the principles are could be trimmed. However, it avoids explaining concepts Claude already knows.

2 / 3

Actionability

The 'Steps' section provides a concrete 5-step process for applying principles, which is helpful. However, the actual principle content is deferred entirely to references/principles.md — the skill body itself contains only one-line summaries without executable guidance, concrete examples, or specific commands. An agent reading only this file wouldn't know how to apply any individual principle.

2 / 3

Workflow Clarity

The 5-step workflow in the 'Steps' section is clearly sequenced and logical, but lacks validation checkpoints or feedback loops. Step 3 mentions 'run the per-principle test' but doesn't explain what happens if it fails (beyond step 4's general guidance). There's no explicit verify-and-retry loop for ensuring compliance.

2 / 3

Progressive Disclosure

The skill is well-structured as an overview with a clear reference index pointing to one level of depth (references/principles.md). The summary list serves as a quick index, the steps section provides application guidance, and detailed content is appropriately deferred to the reference file with clear signaling about when to load it.

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.