bl-init
Initialize git-branchless in the current repository from the current branch
81
77%
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 ./plugins/git-workflow/skills/bl-init/SKILL.mdQuality
Discovery
N/ABased on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
Something went wrong
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides excellent actionability with concrete commands and clear workflow steps, but suffers from verbosity due to redundant interactive flow examples that repeat the same information in different formats. The content would benefit from consolidating examples and moving detailed scenarios to a separate file.
Suggestions
Move the detailed interactive flow examples to a separate EXAMPLES.md file and reference it from the main skill
Remove redundancy between 'Execution Instructions' and 'Interactive Flow' sections - choose one format
Consolidate the 4 interactive examples into 1-2 representative cases that cover the key variations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains significant redundancy - the interactive flow examples repeat information already covered in execution instructions, and the multiple example outputs are verbose. The core information could be conveyed in roughly half the tokens. | 2 / 3 |
Actionability | Provides fully executable commands (`git branchless init --main-branch <branch>`, `git checkout --detach`), concrete examples with actual command syntax, and clear error handling with specific resolutions. | 3 / 3 |
Workflow Clarity | Clear 6-step sequence with explicit checkpoints (check prerequisites, verify installation). The workflow includes validation steps and shows what to do when already initialized. The interactive flow examples demonstrate the feedback loop clearly. | 3 / 3 |
Progressive Disclosure | Content is reasonably structured with sections, but the extensive interactive flow examples (4 separate scenarios) bloat the main file when they could be in a separate EXAMPLES.md. No references to external documentation for advanced usage. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- jpoutrin/product-forge
- Commit
0ebe7ae
- 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.