content-gap-analysis

Find content gaps: topics and keywords competitors cover that you don't, with editorial calendar. 内容缺口/选题规划

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 ./.cursor/skills/content-gap-analysis/SKILL.md

Quality

Content

85%

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, actionable research workflow with explicit validation checkpoints and clean progressive disclosure to real reference files, hindered only by minor redundancy and padding that slightly reduce conciseness.

Suggestions

Collapse the duplicate 'Use this when...' trigger sentences in the 'When This Must Trigger' section into a single statement to remove redundancy.

Trim the opening summary so it does not restate the frontmatter description verbatim, and tighten the 'Tips for Success' list to non-obvious guidance only.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean and action-oriented, but includes redundancy (the opening summary restates the description, and 'When This Must Trigger' repeats two near-identical 'Use this when...' sentences) and minor padding in the tips section, matching 'mostly efficient but could be tightened'.	2 / 3
Actionability	The 9-step Instructions give concrete, specific, copy-paste-ready guidance — explicit keyword categories (High Priority, Quick Wins, Long-term), a filled-in Analysis Parameters template, and defined report tiers — making the guidance actionable without code, which is acceptable for an instruction-only skill.	3 / 3
Workflow Clarity	A clearly sequenced 9-step workflow is paired with an explicit Validation Checkpoints section containing Input and Output checklists (e.g., 'Every recommendation cites specific data points', 'Source of each data point clearly stated'), matching 'clear sequence with explicit validation steps'.	3 / 3
Progressive Disclosure	The body is a clear overview pointing to three well-signaled, one-level-deep references (analysis-templates.md, gap-analysis-frameworks.md, example-report.md) that exist as real bundle files, with a dedicated Reference Materials section for easy navigation.	3 / 3
	Total	11 / 12 Passed

Description

67%

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, clearly naming the domain and concrete actions, but lacks an explicit 'Use when...' trigger clause and only offers limited natural trigger-term coverage.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when finding content gaps between two domains or identifying topics competitors cover that you don't') to satisfy the completeness 'when' requirement.

Broaden trigger-term coverage with natural user phrasings such as 'what am I missing', 'topic gaps', or 'what should I cover next' rather than relying on a single English trigger plus localized terms.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — 'Find content gaps: topics and keywords competitors cover that you don't, with editorial calendar' — covering missing topics, untapped keywords, and calendar creation, matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	The 'what' is clearly stated but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description text, which per the guidelines caps completeness at 2.	2 / 3
Trigger Term Quality	Includes one natural English trigger ('Find content gaps') plus localized terms ('内容缺口/选题规划'), but lacks common English variations a user would naturally say (e.g., 'what am I missing', 'topic gaps'), matching 'some relevant keywords but missing common variations'.	2 / 3
Distinctiveness Conflict Risk	Targets a clear niche — competitive content gap analysis with topics, keywords, and editorial calendar — reinforced by multilingual terms, making it unlikely to trigger for the wrong skill.	3 / 3
	Total	10 / 12 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
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: MODSetter/SurfSense
Path: .cursor/skills/content-gap-analysis/SKILL.md
Commit: 3b319ce

Reviewed: about 14 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.