Name: contract-and-proposal-writer
Rating: 64.8 (1 reviews)
Author: alirezarezvani

contract-and-proposal-writer

Generate professional, jurisdiction-aware business documents: freelance contracts, project proposals, SOWs, NDAs, and MSAs. Structured Markdown output with docx conversion instructions. Covers US (Delaware), EU (GDPR), UK, and DACH (German law) jurisdictions. Not a substitute for legal counsel — use as strong starting points. Use when drafting a freelance contract, preparing a client proposal, writing an SOW for a new engagement, or producing an NDA before sharing sensitive material.

Quality

76%

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/contract-and-proposal-writer/SKILL.md

The canonical home for this skill is contract-and-proposal-writer in alirezarezvani/claude-skills

Quality

Content

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

Highly actionable content with concrete templates and commands, but it is hurt by inlining full templates that should be separate reference files and by missing validation checkpoints in the workflow. Splitting templates out and adding a fill-verification step would lift the weaker dimensions.

Suggestions

Move Templates A/B/C and the GDPR addendum block into separate reference files (e.g. references/template-fixed-price.md, references/gdpr-dpa.md) and link to them from SKILL.md to improve progressive disclosure and reduce token bulk.

Add an explicit validation checkpoint between 'Generate & Fill' and 'Convert to DOCX' that verifies every [BRACKETED] placeholder is resolved (none left as 'REQUIRED') and that the selected template matches the requested jurisdiction before conversion.

Trim redundancy between the frontmatter description and the 'Overview' section, and consider a brief 'Quick start' pointer to the most common template so the top of the file stays lean.

Dimension	Reasoning	Score
Conciseness	The prose is efficient, but three full contract templates plus a complete GDPR addendum are inlined directly in SKILL.md, adding substantial token bulk that could live in separate reference files.	3 / 5
Actionability	Provides executable pandoc conversion commands, ready-to-fill [BRACKETED] templates, a concrete requirements checklist, and jurisdiction-specific clause guidance covering the common cases.	5 / 5
Workflow Clarity	The four-step workflow (Gather -> Select -> Generate & Fill -> Convert) is sequenced, but there is no validation checkpoint confirming all placeholders are filled or that jurisdiction/template selection is consistent before producing the docx.	3 / 5
Progressive Disclosure	No bundle files exist and the full templates and GDPR addendum block are inlined rather than split into one-level-deep referenced files, so content that clearly belongs in separate files is inlined.	2 / 5
	Total	13 / 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, well-rounded description that concretely names capabilities, jurisdictions, and use-when triggers in third person. It is just shy of perfect only on trigger-term coverage, where a few natural synonyms could be added.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete document types and actions ('freelance contracts, project proposals, SOWs, NDAs, and MSAs' plus 'docx conversion instructions') with comprehensive coverage of the domain.	5 / 5
Completeness	Explicitly answers both what ('Generate professional, jurisdiction-aware business documents...') and when ('Use when drafting a freelance contract...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Strong natural triggers ('drafting a freelance contract', 'preparing a client proposal', 'writing an SOW', 'producing an NDA') but a few common synonyms/variations are absent, so it is just below comprehensive.	4 / 5
Distinctiveness Conflict Risk	The jurisdiction-aware legal/business-document niche is distinct and the triggers are specific enough that overlap with unrelated skills is minimal.	5 / 5
	Total	19 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: .gemini/skills/contract-and-proposal-writer/SKILL.md
Commit: 19392f7

Reviewed: ~3 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.