Content
65%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with strong executable code, but weakened by redundancy (repeated Next-Gen caveats, re-explained SAFe basics) and a destructive bulk-delete workflow lacking validation checkpoints. Splitting templates/reference into bundle files would improve progressive disclosure.
Suggestions
Add a confirmation/validation checkpoint before bulkDeleteIssues runs (e.g., require an explicit dry-run count and user confirmation) so the destructive workflow clears the workflow_clarity cap.
De-duplicate the Next-Gen vs Classic caveats: state the parent-field and 'Subtask' naming rules once in the comparison table and reference it from the templates instead of repeating inline.
Move the Epic/Story/Subtask templates and the custom-field tables into separate reference files (e.g., references/templates.md) and summarize them in SKILL.md to reduce the monolithic footprint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient code-focused content, but the Next-Gen caveat ('NOT customfield_10014', 'Subtask not Sub-task') is repeated across 3+ locations, and the SAFe Best Practices section re-explains INVEST and Given-When-Then that Claude already knows. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready JavaScript covering the common cases (create epic with stories, story with subtasks, bulk delete, find epic-link field) with complete fetch payloads and ADF structures. | 5 / 5 |
Workflow Clarity | Sequences are clearly numbered, but the destructive/batch bulkDeleteIssues operation has no validation or confirmation checkpoint, capping this dimension at 3 per the rubric. | 3 / 5 |
Progressive Disclosure | Section headers and tables provide some structure, but the ~450-line file is monolithic with no bundle files; templates and API reference that could live in separate files are inlined, and only external URLs are referenced. | 3 / 5 |
Total | 14 / 20 Passed |