jira-spaces
Manage Confluence spaces for project documentation. Create, list, and delete spaces with templates. Use when setting up project documentation structure or managing Confluence content areas.
80
75%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./data/skills-md/01000001-01001110/agent-jira-skills/jira-spaces/SKILL.mdQuality
Discovery
85%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured skill description that clearly communicates what it does and when to use it. It names specific actions and targets a clear niche (Confluence spaces). The main weakness is that trigger term coverage could be broader to capture more natural user phrasings.
Suggestions
Add more natural trigger terms users might say, such as 'wiki', 'knowledge base', 'workspace', or 'Confluence setup' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create, list, and delete spaces with templates.' Also specifies the domain clearly as Confluence spaces for project documentation. | 3 / 3 |
Completeness | Clearly answers both what ('Manage Confluence spaces... Create, list, and delete spaces with templates') and when ('Use when setting up project documentation structure or managing Confluence content areas') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Confluence', 'spaces', 'project documentation', and 'templates', but misses common variations users might say such as 'wiki', 'knowledge base', 'workspace', or 'content management'. Coverage is decent but not comprehensive. | 2 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to Confluence spaces specifically, which is a distinct niche. The mention of 'Confluence' and space-level operations (create, list, delete) distinguishes it well from general documentation skills or Confluence page-level skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides solid, actionable API reference content with executable code examples and good error handling documentation. Its main weaknesses are moderate verbosity (full response bodies, space type explanations) and missing validation/feedback loops for destructive operations like space deletion. The content would benefit from being split into an overview with references to detailed API docs.
Suggestions
Add explicit validation steps for the delete workflow: list space contents before deletion, check for 202 response, poll for completion status.
Move the detailed request/response examples into a separate REFERENCE.md file and keep SKILL.md as a concise overview with quick-start patterns.
Trim response JSON examples to show only essential fields, and remove the Space Types table and space key conventions which Claude can infer from context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary content like the space types table and space key conventions that Claude would already know or could infer. The response examples are helpful but verbose - the full JSON responses could be trimmed. The 'When to Use' section is somewhat redundant with the description. | 2 / 3 |
Actionability | The skill provides fully executable TypeScript code for creating, listing, and deleting spaces with complete request/response examples. CLI usage examples are concrete and copy-paste ready. Error codes with resolutions are specific and actionable. | 3 / 3 |
Workflow Clarity | The 'Common Patterns' section shows a multi-step workflow for creating a project documentation space, but lacks validation checkpoints. The delete operation has a WARNING but no explicit verification step (e.g., list contents before deleting, confirm deletion completed). For a destructive operation like space deletion, the absence of a validate-before-proceeding feedback loop caps this at 2. | 2 / 3 |
Progressive Disclosure | The content is reasonably structured with clear sections, but it's somewhat monolithic - the full API reference with request/response examples could be split into a separate reference file. The 'Related Skills' section provides good cross-references, but the inline content is heavy for a SKILL.md overview. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- NeverSight/skills_feed
- Commit
caee3d2
- Reviewed
Table of Contents
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.