CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commercial-policy

Use when designing or revising a company's commercial policy — the rules of engagement governing discounts off list price, approver thresholds, exception flows, and the deal framework that Deal Desk and AEs operate under. Covers discount matrix design (ARR band x term length x payment terms x strategic value), commercial policy design, exception policy, discount governance, approval thresholds, deal framework structure, and policy linting (contradictions, gaps, cliff edges, gaming surfaces). For Head of Commercial, Head of Deal Desk, VP Sales, or RevOps at the policy-design moment — NOT per-deal application (that is deal-desk) and NOT pricing model selection (that is pricing-strategist).

67

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is commercial-policy in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, expert-level body with genuinely concrete commands, data schemas, and expected outputs, plus a well-sequenced workflow with a lint gate. The weaknesses are repetition (boundary and precedent content stated 3-4 times across sections), an inlined forcing-question library that belongs in a reference file, referenced bundle files that do not exist in the skill as shipped, and a missing fix→re-lint→publish loop.

Suggestions

Consolidate the repeated boundary/precedent content: the deal-desk/pricing-strategist distinction appears in Purpose, When-to-use, Assumptions, and the Distinct-from table, and the 'Maria approved 28% on Acme' precedent anecdote appears three times — state each once and cross-reference.

Move the 8-question forcing-question library (recommended answers + canon citations) into a references/ file, keeping one-line question summaries in SKILL.md, and ship the referenced scripts/, references/, and assets/ files so every path in the body resolves.

Add an explicit re-validation loop to the workflow: after resolving BLOCKER findings, re-run policy_linter.py and publish only on PASS or PASS_WITH_WARNINGS.

DimensionReasoningScore

Conciseness

Prose is expert-density and assumes Claude's competence (no explaining ARR, NRR, or discounting basics), but the same content repeats across sections: the precedent-loop anecdote ('Reps are citing "Maria approved 28% on Acme last quarter"' in When-to-use, 'Letting precedent set policy... Maria approved 28%' in Anti-patterns, and forcing-question 6) and the deal-desk/pricing-strategist boundary appears four times (Purpose, 'Do NOT use this skill', Assumptions, and the Distinct-from table). Consolidating these would cut 20-30% of tokens — more than the 'minor trim instances' of the anchor at 4, but not padded with concepts Claude already knows, so not a 2.

3 / 5

Actionability

Copy-paste-ready commands with exact flags ('python3 scripts/discount_matrix_builder.py --input policy_intake.json --profile saas --output json > matrix.json'), exact intake fields ('arr, discount_pct, term_months, payment_terms_days, strategic_value, win_lost, nrr_12mo per deal'), and concrete expected outputs ('lints to FAIL with 4 BLOCKERs + 6 MAJORs + 2 MINORs'). Falls short of fully-executable because the referenced scripts/ and assets/ files are not present in the bundle, so the commands cannot be run as shipped, and the input JSON schema is only discoverable via --sample.

4 / 5

Workflow Clarity

A clear 5-step sequence with an explicit validation gate ('Resolve every BLOCKER before publishing the matrix to AEs'), THIN-data flags ('Cells with n < 5 observed deals are flagged THIN'), NRR review flags, and a quarterly re-run loop ('Re-run the builder and the linter every quarter'). Not a 5 because the fix→re-validate loop is implied rather than stated — after resolving BLOCKERs there is no explicit instruction to re-run policy_linter.py and confirm PASS before publishing, which is the exact 'minor validation gap' of the anchor at 4.

4 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled (a References section with per-file descriptions and source counts), but the actual bundle contains no references/, scripts/, or assets/ directories — every referenced path (discount_governance_canon.md, policy_design_template.md, the three .py scripts) is absent, so the disclosed structure cannot be verified. Additionally, substantial content that belongs in a reference file — the 8-question forcing-question library with recommended answers and canon citations (~35 lines) — is inlined in SKILL.md, fitting the 'could be better organized / content that should be separate is inline' anchor at 3 rather than the 'appropriately placed' anchor at 4.

3 / 5

Total

14

/

20

Passed

Description

100%Weight 40%Scale 1-5

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

An exemplar description: concrete capability list with parameter-level specificity, explicit 'Use when' trigger plus role targeting, and explicit negative boundaries against the two most-confusable sibling skills. Third-person imperative voice matches the good-example pattern with no first/second-person phrasing to penalize.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities with dimension-level detail: 'discount matrix design (ARR band x term length x payment terms x strategic value)', 'exception flows', 'approval thresholds', and 'policy linting (contradictions, gaps, cliff edges, gaming surfaces)'. Coverage spans all three of the skill's tools with no gaps, matching the comprehensive-coverage anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

Explicitly answers both questions with concrete triggers: what ('designing or revising a company's commercial policy — the rules of engagement governing discounts off list price, approver thresholds, exception flows') and when ('Use when designing or revising...', 'For Head of Commercial, Head of Deal Desk, VP Sales, or RevOps at the policy-design moment'). The 'when' is fully explicit including role targeting and negative boundaries, exceeding the 'could be more explicit' anchor at 4.

5 / 5

Trigger Term Quality

Natural phrases the target user would actually say are densely present: 'commercial policy', 'discount matrix', 'discount governance', 'approval thresholds', 'exception flows', 'discounts off list price', plus role names ('Head of Deal Desk', 'RevOps'). Synonym coverage (discount policy / commercial policy / governance) is thorough; nothing natural is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

Hard negative boundaries ('NOT per-deal application (that is deal-desk) and NOT pricing model selection (that is pricing-strategist)') explicitly disambiguate the two closest siblings. Clear niche — designing the policy artifact versus applying it per deal — with minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 16 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/commercial-policy/SKILL.md

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.