CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bamboohr

BambooHR integration. Manage hris data, records, and workflows. Use when the user wants to interact with BambooHR data.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/bamboohr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The operational core is strong: executable Membrane CLI commands, a useful actions table, and solid connection-state handling. Quality is dragged down by a large padded overview section, dangling step references ("Step 2", "1b"), and the absence of any progressive disclosure into reference files.

Suggestions

Delete the what-is-BambooHR paragraph and the ~60-line entity noun list — they add no actionable guidance; if the entity catalog matters, move it to a references/ file and link it clearly.

Replace the broken "skip to Step 2" and "1b" references with a clearly numbered workflow (1. Install, 2. Authenticate, 3. Connect, 4. Discover actions, 5. Run) so the sequence references resolve.

Clarify the placeholder in "membrane connection ensure \"\"" with a real example URL/domain and show a sample value for the --tenant flag so the auth commands are fully copy-paste ready.

DimensionReasoningScore

Conciseness

The CLI operational sections are lean and command-driven, but the opening paragraph explaining what BambooHR is ("BambooHR is an HRIS platform that helps small and medium-sized businesses manage employee data, payroll, benefits...") and the ~60-line noun list ("Employee", "Time Off", "Report" ... "Subsidiary") capped only by "Use action names and parameters as needed" are significant padding. Mostly efficient with unnecessary sections that could be cut — anchor 3 fits better than anchor 2 because the majority of the document is tight.

3 / 5

Actionability

Commands are concrete and mostly copy-paste ready: "npm install -g @membranehq/cli@latest", "membrane action list --connectionId=CONNECTION_ID --intent \"QUERY\" --limit 10 --json", "membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}' --json", plus the proxy flags table and popular-actions table. Minor gaps keep it below anchor 5: "membrane connection ensure \"\"" shows a confusing empty-string placeholder with no explanation of what belongs there, and "membrane login --tenant" shows no value for the flag.

4 / 5

Workflow Clarity

The install → login → connect → search → run sequence is logical, and the connection section has genuinely good state handling (poll while BUILDING, branch on CLIENT_ACTION_REQUIRED, check error on CONFIGURATION_ERROR). However "If the returned connection has state: \"READY\", skip to Step 2" references a Step 2 that never appears, and "#### 1b. Wait for the connection to be ready" has no numbered Step 1, leaving the sequence references broken — this sits between anchors 3 and 4 and the incoherent numbering pulls it to 3.

3 / 5

Progressive Disclosure

The document has clear section headers and no nested references, but no bundle files exist and content that belongs in a separate reference file — the 59-item entity noun list and arguably the full popular-actions table — is inlined. Matches anchor 3 ('Some structure... content that should be separate is inline'); it is above anchor 2 because structure and navigation are otherwise good.

3 / 5

Total

13

/

20

Passed

Description

61%Weight 40%Scale 1-5

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 has a clear niche and an explicit 'Use when' trigger, but its capability statement is generic. Replacing "Manage hris data, records, and workflows" with 2-3 concrete actions would lift both specificity and completeness.

Suggestions

List concrete capabilities instead of generic verbs, e.g. "Create and update employee records, manage time-off requests, and run custom reports in BambooHR".

Add natural synonyms users would say — "HR data", "employee directory", "time off", "payroll" — to broaden trigger coverage.

Keep the explicit 'Use when' clause but tie it to those concrete phrases, e.g. "Use when the user mentions BambooHR, HR data, employee records, or time-off requests".

DimensionReasoningScore

Specificity

"Manage hris data, records, and workflows" and "interact with BambooHR data" name the domain but rely on generic verbs with no concrete actions (e.g., no mention of creating time-off requests, updating employees, or running reports). This matches anchor 2 ('Names the domain but actions are minimal or generic') and falls short of anchor 3, which requires 1-2 genuinely concrete actions.

2 / 5

Completeness

Both parts are present: a what ("Manage hris data, records, and workflows") and an explicit when ("Use when the user wants to interact with BambooHR data"). Not anchor 5 because the 'what' lacks the concrete action list that anchor 5's example includes; it exceeds anchor 3 because the 'when' clause is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

"BambooHR", "hris data", and "records" are natural terms a user might say, but common variations and synonyms like "HR", "employees", "payroll", or "time off" are absent. Matches anchor 3 ('Some relevant keywords but missing common variations or synonyms'), below anchor 4's good-but-incomplete coverage.

3 / 5

Distinctiveness Conflict Risk

"BambooHR" is a specific named product and the trigger "Use when the user wants to interact with BambooHR data" is distinct, giving it a clear niche with minimal overlap risk against other skills. Matches anchor 5.

5 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/bamboohr/SKILL.md

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.