persuasion-through-interest-alignment

Use when persuading officials or leaders by aligning your proposal with their self-interest. Demonstrated by Kuai Tong and Li Yiji, this technique researches the target's fears, frames problems objectively, and presents solutions that benefit the listener.

Quality

71%

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_188/SKILL.md

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 well-structured, concise instruction-only skill with a clear sequenced procedure, a grounded worked example, and an explicit verification checklist. The main gaps are a missing failure-feedback loop in verification and no reusable phrasing templates for direct deployment.

Suggestions

Add a brief feedback loop to the Verification section describing what to do when a check fails (e.g. re-research the target's fears, reframe, then re-attempt).

Provide one or two reusable phrasing templates or openers the persuader can adapt, beyond the single historical example.

Trim redundancy between the step sub-bullets and the 'Warning Signs to Avoid' section to tighten token efficiency.

Dimension	Reasoning	Score
Conciseness	The body is lean and well-sectioned with bullet points and no padding about what persuasion is, but the 'Warning Signs' section partially restates the steps, leaving minor instances that could be trimmed; not a 5 because not every token is essential.	4 / 5
Actionability	A concrete six-step procedure with specific sub-bullets plus a worked example with quoted phrases ('I heard you will die, so I came to mourn') gives mostly actionable guidance; the minor gap is the absence of reusable phrasing templates one could deploy directly.	4 / 5
Workflow Clarity	A clearly numbered six-step sequence is paired with an explicit three-item 'Verification' checklist, giving clear checkpoints; it falls short of 5 only because there is no feedback loop describing what to do when a verification check fails.	4 / 5
Progressive Disclosure	As a single-purpose skill with no bundle files, the content is well-organized into clear sections (Overview, Core Principle, Procedure, Example, Warning Signs, Verification) with no nested references; it is just over the ~50-line simple-skill threshold, so it earns 4 rather than 5.	4 / 5
	Total	16 / 20 Passed

Description

67%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 solid description that states both what the technique does and when to use it, with a concrete 'Use when' trigger and several specific actions. It could be improved by adding natural trigger synonyms and more explicit 'or when the user mentions...' phrasing.

Suggestions

Add natural trigger synonyms users would actually say, e.g. 'Use when persuading, convincing, or winning over officials, leaders, or decision-makers'.

Expand the 'when' clause with an explicit 'or when the user mentions...' trigger phrase to reach full completeness.

Consider noting the converse signal (e.g. 'not for coercive or deceptive tactics') to further reduce conflict with adjacent persuasion/rhetoric skills.

Dimension	Reasoning	Score
Specificity	Names the domain and three concrete actions ('researches the target's fears, frames problems objectively, and presents solutions that benefit the listener'), matching the 'several specific actions' anchor; not a 5 because coverage is narrow rather than comprehensive.	4 / 5
Completeness	It answers both 'what' (researches fears, frames problems objectively, presents benefit-aligned solutions) and 'when' ('Use when persuading officials or leaders...'), but the 'when' lacks the 'or when the user mentions...' style explicit trigger phrasing that would lift it to a 5.	4 / 5
Trigger Term Quality	The trigger 'Use when persuading officials or leaders' gives a relevant natural phrase, but it misses common synonyms users might say ('convince', 'win over', 'lobby', 'negotiate'), so it sits at 'some relevant keywords but missing variations' rather than full coverage.	3 / 5
Distinctiveness Conflict Risk	The niche (interest-aligned persuasion of officials/leaders, tied to named historical strategists) is fairly distinct with clear triggers, but 'persuasion' broadly could overlap with generic negotiation or rhetoric skills, leaving minor overlap risk rather than a clear 5.	4 / 5
	Total	15 / 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_188/SKILL.md
Commit: 6b836e3

Reviewed: 2 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.