CtrlK
BlogDocsLog inGet started
Tessl Logo

persuasive-diplomacy-technique

Use when persuading a resistant authority figure to take difficult but necessary action. Employs a gradual empathetic approach: build rapport through shared humanity, introduce topics indirectly, present arguments through historical examples, appeal to long-term interests, and let conclusions be self-evident.

66

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./kg/ontology/ontology-v1/skus/procedural/skill_116/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 clearly structured, actionable instruction-only skill with a sound multi-step workflow and verification checklist. It is efficient but has mild redundancy across overview sections and would benefit from a concrete worked example.

Suggestions

Add a brief worked example or sample dialogue illustrating the six steps end-to-end to lift actionability from abstract guidance to directly applicable practice.

Merge or trim the overlap between 'Overview', 'Core Principles', and 'Key Techniques' (e.g. 'Empathy first' restates 'Build common ground') to improve conciseness.

Tighten the Verification section into explicit checkpoints tied to specific steps rather than a retrospective checklist, and consider folding 'Expected Outcomes' into the relevant steps to reduce redundancy.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's intelligence without explaining basic persuasion concepts, but 'Core Principles', 'Key Techniques', and 'Overview' partially restate one another and could be tightened.

4 / 5

Actionability

Concrete, specific behavioral guidance is given per step (e.g. 'Share personal vulnerabilities or challenges', 'Use historical or familiar examples'), but no worked example or sample dialogue grounds the technique in practice.

4 / 5

Workflow Clarity

Six steps are clearly sequenced and a three-item Verification checklist is present; however the verification is a post-hoc checklist rather than an explicit validate->fix->retry feedback loop.

4 / 5

Progressive Disclosure

The skill is self-contained with well-labeled sections and no nested references, but at roughly 60 lines with some redundant sections it sits just above the simple-skill threshold and has minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

83%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 well-crafted description that clearly states both purpose and trigger conditions with several concrete techniques. It is distinctive and complete, with only minor gaps in keyword synonym coverage and action concreteness.

DimensionReasoningScore

Specificity

Lists five concrete techniques ('build rapport through shared humanity', 'introduce topics indirectly', 'present arguments through historical examples', 'appeal to long-term interests', 'let conclusions be self-evident'), but they are strategy-level rather than discrete operations, leaving minor gaps in concreteness versus the comprehensive anchor.

4 / 5

Completeness

It explicitly answers both 'what' (a gradual empathetic approach with named techniques) and 'when' via a concrete 'Use when persuading a resistant authority figure...' trigger clause, matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases appear ('persuading a resistant authority figure to take difficult but necessary action'), but common synonyms such as 'convince', 'negotiate', or 'diplomacy' are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The 'resistant authority figure' niche is fairly distinct, but it could still overlap with broader persuasion, negotiation, or diplomacy skills, so minor overlap risk remains.

4 / 5

Total

17

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
baojie/shiji-kb
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.