diplomatic-persuasion-through-emotional-appeal

Use when persuading a superior to reverse hostility toward an ally. Combines emotional appeal, intermediary strategy, and evidence of loyalty to reframe grievances and restore relations.

Quality

80%

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 ./kg/ontology/ontology-v1/skus/procedural/skill_201/SKILL.md

Quality

Content

78%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 content is a well-structured, concise instruction skill with clear sequencing and explicit verification checkpoints; its main limitation is that some steps and decision branches could be made still more actionable.

Suggestions

Tighten a few step descriptions (e.g. merge 'Show vulnerability' guidance into 'Reframe the narrative') to push conciseness toward a 5.

Add a concrete example dialogue or phrasing template for the intermediary ask to strengthen actionability.

Make the feedback loop explicit in Steps (e.g. 'If the intermediary refuses, identify an alternate advocate') rather than only in Verification.

Dimension	Reasoning	Score
Conciseness	The body is lean and free of padding or over-explanation of concepts Claude already knows; each step and section earns its place with only minor tightening possible.	4 / 5
Actionability	Steps give concrete behavioral direction ('Begin with tears or visible distress', 'Approach someone close to the superior') and Decision Points give branching guidance; as an instruction-only skill the absence of code is not penalized, with only minor gaps.	4 / 5
Workflow Clarity	A clearly numbered 1-7 sequence is paired with a Verification section that provides explicit checkpoints ('Confirm the intermediary has direct access', 'Check that the superior's response shifted'); minor validation gaps keep it just below a 5.	4 / 5
Progressive Disclosure	At under 50 lines with no need for external references, the well-organized sections (Overview, Steps, Decision Points, Expected Outcomes, Verification) satisfy the simple-skill exception for a top progressive-disclosure score.	5 / 5
	Total	17 / 20 Passed

Description

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

The description is specific and distinctive with explicit what/when guidance, but its trigger-term coverage is narrow — a single scenario phrasing without synonyms or natural variations a user would actually say.

Suggestions

Broaden the 'Use when' clause to include natural variations a user might say, e.g. 'Use when mediating a conflict, defusing a superior's anger, or advocating for an accused ally.'

Add 1-2 concrete trigger phrases or synonyms (e.g. 'interceding', 'pleading on behalf of') to improve keyword coverage.

Dimension	Reasoning	Score
Specificity	Names the persuasion domain and several concrete actions ('emotional appeal, intermediary strategy, and evidence of loyalty to reframe grievances and restore relations'), with only minor coverage gaps, matching the 'several specific actions' anchor.	4 / 5
Completeness	Both a clear 'what' (combines emotional appeal, intermediary strategy, loyalty evidence) and an explicit 'when' ('Use when persuading a superior to reverse hostility toward an ally') are present, though the trigger scenario is narrow rather than broadly concrete.	4 / 5
Trigger Term Quality	A single specific trigger phrase ('Use when persuading a superior to reverse hostility toward an ally') is present, but it lacks synonyms or the natural variations a user might say, matching the 'some relevant keywords but missing variations' anchor.	3 / 5
Distinctiveness Conflict Risk	The trigger describes a highly specific niche (persuading a superior to reverse hostility toward an ally) with distinct phrasing and minimal overlap with other skills, matching the 'clear niche with distinct triggers' anchor.	5 / 5
	Total	16 / 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: baojie/shiji-kb
Path: kg/ontology/ontology-v1/skus/procedural/skill_201/SKILL.md
Commit: 6b836e3

Reviewed: 13 days 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.