Automate BambooHR tasks via Rube MCP (Composio): employees, time-off, benefits, dependents, employee updates. Always search tools first for current schemas.
65
53%
Does it follow best practices?
Impact
79%
1.27xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/bamboohr-automation/SKILL.mdQuality
Discovery
57%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 identifies a clear niche (BambooHR automation via a specific MCP integration) and lists relevant domain areas, making it distinctive. However, it lacks concrete action verbs for what it does with each entity, misses some natural trigger term variations, and has no explicit 'Use when...' clause to guide skill selection.
Suggestions
Add a 'Use when...' clause such as 'Use when the user asks about BambooHR, employee records, PTO/time-off requests, benefits enrollment, or HR data management.'
Replace category nouns with specific action phrases, e.g., 'Look up employee records, submit and approve time-off requests, manage benefits enrollments, add dependents, update employee profiles.'
Include common synonyms and variations users might say: 'PTO', 'leave requests', 'HR system', 'employee directory', 'vacation days'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists domain areas (employees, time-off, benefits, dependents, employee updates) but these are more like categories than concrete actions. It doesn't specify what actions are performed on these entities (e.g., 'create employees', 'approve time-off requests', 'update benefit enrollments'). | 2 / 3 |
Completeness | The 'what' is partially addressed (automate BambooHR tasks across several domains), but there is no explicit 'Use when...' clause or equivalent trigger guidance. The instruction to 'always search tools first' is operational guidance, not a trigger condition. | 2 / 3 |
Trigger Term Quality | Includes relevant keywords like 'BambooHR', 'employees', 'time-off', 'benefits', 'dependents' which users might naturally mention. However, it misses common variations like 'PTO', 'leave requests', 'HR system', 'employee directory', or 'payroll'. | 2 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to BambooHR via Rube MCP (Composio), which is a very specific integration. It's unlikely to conflict with other skills given the explicit platform and tooling references. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a competent BambooHR integration skill with good structural organization, clear workflow sequencing, and useful quick-reference material. Its main weaknesses are significant content repetition (especially pitfalls), lack of executable examples (pseudocode steps instead of actual tool call JSON), and missing validation/verification steps after data-modifying operations. Trimming redundancy and adding concrete call examples with error handling would meaningfully improve it.
Suggestions
Add explicit validation steps after data-modifying operations (e.g., 'Call GET_EMPLOYEE after UPDATE_EMPLOYEE to verify changes took effect') to improve workflow safety.
Replace pseudocode step lists with actual executable MCP tool call examples showing real JSON parameters and expected response structures.
Consolidate the per-workflow pitfalls into the single 'Known Pitfalls' section to eliminate repetition and reduce token count by ~30%.
Consider splitting the detailed parameter documentation and pitfalls into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-organized but contains significant repetition—pitfalls are listed per workflow AND again in a consolidated 'Known Pitfalls' section, and the quick reference table duplicates information already covered in each workflow. Some explanatory text could be trimmed (e.g., 'When to use' descriptions are somewhat obvious). | 2 / 3 |
Actionability | Tool names and parameter lists are concrete and specific, but the 'code examples' are pseudocode step lists rather than actual executable MCP tool calls with real parameter JSON. Key details like exact field names or response shapes are deferred to 'check RUBE_SEARCH_TOOLS' rather than provided directly. | 2 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with numbered steps and prerequisite/optional annotations, which is good. However, there are no explicit validation or verification checkpoints—for example, after updating an employee or creating a time-off request, there's no step to verify the operation succeeded or handle errors, which is important for data-modifying operations. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and a quick reference table, but it's a monolithic ~200-line document with no bundle files. The repeated pitfalls sections and detailed per-workflow parameter lists could be split into separate reference files. The single external link to Composio docs is helpful but the skill itself could benefit from splitting detailed parameter references out. | 2 / 3 |
Total | 8 / 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 | |
364c6b2
Table of Contents
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.