Name: commercial-policy
Rating: 58.4 (1 reviews)
Author: alirezarezvani

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

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/commercial-policy/SKILL.md

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

Quality

Content

45%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.

The body is well-structured with a clear sequenced workflow and concrete commands, but its quality is undercut by referencing seven bundle files that do not exist, rendering the progressive-disclosure navigation and the cited commands non-functional. Some repetition across sections could also be trimmed.

Suggestions

Bundle the seven referenced files the body cites (scripts/discount_matrix_builder.py, scripts/exception_router.py, scripts/policy_linter.py, references/discount_governance_canon.md, references/policy_design_canon.md, references/policy_anti_patterns.md, assets/policy_design_template.md) so the signaled navigation actually resolves.

Either ship the three Python scripts or explicitly mark the Quick examples as illustrative stubs; today every copy-paste command fails because the scripts are absent.

De-duplicate the precedent, compensating-commitment, and quarterly-review points that recur across the Anti-patterns, Forcing-question library, and Distinct-from sections to tighten the body.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and it does not explain basics Claude knows, but the precedent/compensating-commitment/quarterly-review themes are restated across the Anti-patterns, Forcing-question library, and Distinct-from sections, so it could be tightened.	3 / 5
Actionability	Concrete, specific commands with flags are provided ('python3 scripts/discount_matrix_builder.py --input policy_intake.json --profile saas --output json'), but every cited script is absent from the bundle, so the copy-paste commands are not actually executable.	3 / 5
Workflow Clarity	A clear 5-step sequence with an explicit validation gate ('Resolve every BLOCKER before publishing the matrix to AEs', 'Lint is the gate'), though an explicit re-lint-after-fix loop is only implied rather than stated in the workflow steps.	4 / 5
Progressive Disclosure	References are clearly signaled and one level deep, but all seven referenced files (3 scripts, 3 references, 1 asset) are missing from the bundle, so navigation to the detailed materials is broken in practice.	2 / 5
	Total	12 / 20 Passed

Description

92%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.

A strong, highly specific description that clearly states what the skill does, when to use it, and who it is for, while explicitly disambiguating it from adjacent skills. Minor room for a few additional natural trigger synonyms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities — 'discount matrix design (ARR band x term length x payment terms x strategic value)', 'exception policy', 'approval thresholds', 'deal framework structure', and 'policy linting (contradictions, gaps, cliff edges, gaming surfaces)' — giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers both what ('rules of engagement governing discounts off list price…') and when ('Use when designing or revising…', 'For Head of Commercial, Head of Deal Desk, VP Sales, or RevOps at the policy-design moment') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural-term coverage ('commercial policy', 'discount matrix', 'exception flows', 'approval thresholds', 'deal framework'), but a few user-sayable synonyms (e.g. 'deal desk policy', 'rebate policy') are absent, keeping it just below comprehensive.	4 / 5
Distinctiveness Conflict Risk	Clear niche with explicit anti-triggers — 'NOT per-deal application (that is deal-desk) and NOT pricing model selection (that is pricing-strategist)' — minimizing conflict risk with sibling skills.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

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.