Skip to content

Review ratings again for: tessl.io (third iteration) #823

@jabrena

Description

@jabrena

Review again the changed results:

https://tessl.io/registry/skills/github/jabrena/cursor-rules-java

Example:

npx tessl skill review --optimize ./skills/114-java-maven-search/SKILL.md

This is the root cause. The reviewer flags the same pattern across all skills:

“This skill functions primarily as a pointer to a reference file rather than providing standalone actionable guidance.”

The specific issues Tessl calls out:

•	No concrete executable examples — no curl commands, no API query templates, no URL patterns. Everything actionable is deferred to a references/ file.
•	Abstract workflow steps — steps like “Use Search API” or “Return coordinates” are too vague to guide execution reliably.
•	No validation checkpoints — no “verify the API returns 200 before proceeding” type gates in the workflow.
•	Redundant content — the “What is covered” bullet lists and “When to use this skill” keyword sections largely duplicate the frontmatter description, wasting tokens.

Previous iteration:

Metadata

Metadata

Assignees

Labels

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions