analyzing-text-with-nlp

Execute this skill enables AI assistant to perform natural language processing and text analysis using the nlp-text-analyzer plugin. it should be used when the user requests analysis of text, including sentiment analysis, keyword extraction, topic modeling, or ... Use when analyzing code or data. Trigger with phrases like 'analyze', 'review', or 'examine'.

Quality

43%

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 ./plugins/ai-ml/nlp-text-analyzer/skills/analyzing-text-with-nlp/SKILL.md

Quality

Content

20%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-sectioned but content-thin: it is filled with generic process boilerplate, contains no executable code or commands, and fails to point to the real bundled assets/scripts that would make it actionable. It reads as a template skeleton rather than working guidance.

Suggestions

Replace the generic boilerplate sections (Best Practices, Instructions, Output) with a concrete worked example showing how to invoke the nlp-text-analyzer plugin or run scripts/analyze_text.py, including real input/output.

Link the existing bundle files from the body (e.g., 'See assets/error_handling_examples.md for rate-limit handling' and 'See assets/analysis_report_template.md for output format') so the detailed materials are surfaced via one-level-deep references.

Tighten or remove filler lines like 'Review the generated output' and 'Apply modifications as needed' to respect the token budget.

Dimension	Reasoning	Score
Conciseness	The body is padded with generic boilerplate ('Review the generated output', 'Apply modifications as needed', 'The skill produces structured output relevant to the task') that adds no technical value Claude doesn't already know, matching the 'verbose; padded with unnecessary context' anchor.	1 / 3
Actionability	There is no executable code or commands anywhere; it describes ('the nlp-text-analyzer plugin processes the text', 'Determine the sentiment as positive') rather than instructs, and never shows how to invoke the bundled analyze_text.py script, matching 'describes rather than instructs'.	1 / 3
Workflow Clarity	A 3-step sequence exists in 'How It Works' (Request Analysis, Text Processing, Insight Extraction), but the steps are high-level conceptual phases rather than a concrete operational procedure with actionable detail, fitting 'steps listed but checkpoints missing or implicit'.	2 / 3
Progressive Disclosure	The body is organized into clear sections, but the existing bundle files (analysis_report_template.md, error_handling_examples.md, example_text_inputs.json, analyze_text.py) are never referenced or linked from the body — the 'Resources' section is only generic ('Project documentation', 'Related skills and commands') — so navigation to the detailed materials is missing.	2 / 3
	Total	6 / 12 Passed

Description

67%Weight 40%Scale 1-3

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 conveys a distinct NLP-text-analysis purpose with explicit trigger guidance, so it clears the completeness bar. It is weakened by broken grammar, a truncated 'or ...', and overly generic trigger verbs ('analyze', 'review', 'examine') that invite conflicts with unrelated skills.

Suggestions

Fix the broken opening ('Execute this skill enables AI assistant...') and complete the truncated 'or ...' so the capability list is clean and comprehensive.

Replace the generic triggers ('analyze', 'review', 'examine') with NLP-specific phrasing (e.g., 'sentiment analysis', 'extract keywords', 'topic modeling', 'named entity recognition') and remove the off-scope 'analyzing code or data' to reduce conflict risk.

Dimension	Reasoning	Score
Specificity	It names the NLP domain and several concrete actions ('sentiment analysis, keyword extraction, topic modeling'), but the garbled opening ('Execute this skill enables AI assistant...') and the truncated 'or ...' keep it from being cleanly comprehensive, fitting the 'names domain and some actions' anchor.	2 / 3
Completeness	It states what the skill does (NLP/text analysis with named tasks) and gives explicit 'when' guidance ('it should be used when the user requests analysis of text', 'Trigger with phrases like...'); the rubric only caps at 2 when a 'Use when...' clause is missing, and one is present.	3 / 3
Trigger Term Quality	The triggers ('analyze', 'review', 'examine') are natural words users say, but they are overly generic and miss common variations, matching 'some relevant keywords but missing common variations' rather than the full coverage of a 3.	2 / 3
Distinctiveness Conflict Risk	The skill targets a clear NLP niche, but the generic trigger words and the broad 'Use when analyzing code or data' phrasing create real overlap with other analysis/review skills, fitting 'somewhat specific but could still overlap'.	2 / 3
	Total	9 / 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
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: jeremylongshore/claude-code-plugins-plus-skills
Path: plugins/ai-ml/nlp-text-analyzer/skills/analyzing-text-with-nlp/SKILL.md
Commit: 0540a62

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