CtrlK
BlogDocsLog inGet started
Tessl Logo

github-automation

Automate GitHub repositories, issues, pull requests, branches, CI/CD, and permissions via Rube MCP (Composio). Manage code workflows, review PRs, search code, and handle deployments programmatically.

75

1.32x
Quality

68%

Does it follow best practices?

Impact

81%

1.32x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/github-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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 is strong in specificity and trigger term coverage, listing many concrete GitHub-related actions with natural keywords. Its main weakness is the absence of an explicit 'Use when...' clause, which would help Claude know precisely when to select this skill. The broad scope covering nearly all GitHub operations could also create overlap with more focused GitHub or code review skills.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to automate GitHub tasks, manage repositories, create or review pull requests, or interact with GitHub APIs via Composio.'

Clarify what distinguishes this from other potential GitHub or Git skills by emphasizing the Composio/Rube MCP integration as the differentiator, e.g., 'Use this skill specifically for programmatic GitHub automation through the Rube MCP tool, not for local git operations.'

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: manage repositories, issues, pull requests, branches, CI/CD, permissions, review PRs, search code, and handle deployments. These are concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers 'what does this do' with specific capabilities, but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the actions listed, which caps this at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'GitHub', 'repositories', 'issues', 'pull requests', 'branches', 'CI/CD', 'permissions', 'PRs', 'code', 'deployments'. Good coverage of terms a user would naturally use when needing GitHub automation.

3 / 3

Distinctiveness Conflict Risk

Mentions 'GitHub' and 'Rube MCP (Composio)' which helps distinguish it, but terms like 'code workflows', 'review PRs', and 'search code' could overlap with generic code review or Git skills. The mention of the specific tool (Composio) helps but the broad scope of actions could still cause conflicts with other GitHub-related skills.

2 / 3

Total

10

/

12

Passed

Implementation

62%

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

This is a comprehensive and well-structured skill for GitHub automation via Rube MCP. Its strengths are excellent workflow clarity with explicit validation checkpoints, safety guards, and detailed pitfall documentation. Its weaknesses are the monolithic length with some content duplication, lack of executable example invocations showing actual MCP call syntax, and missed opportunity to split detailed workflows into separate referenced files.

Suggestions

Add at least one concrete example MCP call per workflow showing actual invocation syntax with sample parameters, rather than only listing tool slugs and parameter names

Consolidate the per-workflow 'Pitfalls' sections into the single 'Known Pitfalls' section to eliminate duplication and reduce overall length

Split detailed per-workflow guides into separate files (e.g., issues.md, pull-requests.md) and keep SKILL.md as a concise overview with references

DimensionReasoningScore

Conciseness

The skill is well-organized but quite lengthy (~250 lines). There's some repetition between per-workflow 'Pitfalls' sections and the consolidated 'Known Pitfalls' section. The quick reference table duplicates information already covered in each workflow section. However, it avoids explaining basic concepts Claude already knows and stays focused on tool-specific details.

2 / 3

Actionability

The skill provides specific tool names, parameter lists, and clear tool sequences for each workflow, which is good. However, there are no executable code examples or copy-paste ready commands — everything is described at the tool-slug level without showing actual MCP call syntax or example payloads. The setup instructions are concrete but the core workflows remain at a descriptive level rather than showing example invocations.

2 / 3

Workflow Clarity

Each workflow has a clear numbered sequence with prerequisite/required/optional annotations, explicit validation checkpoints (e.g., verify mergeable status before merge, check CI status, confirm connection is ACTIVE before proceeding), and safety gates requiring user confirmation for destructive operations. The merge workflow explicitly includes a feedback loop: verify status → merge, with clear failure conditions documented.

3 / 3

Progressive Disclosure

The content is well-structured with clear sections and a useful quick reference table, but it's a monolithic document with no bundle files or references to separate detailed guides. The 200+ lines of workflow details could benefit from being split into separate files (e.g., per-workflow guides), with the SKILL.md serving as a concise overview pointing to them. The single external link to Composio docs is appropriate but insufficient for the volume of content.

2 / 3

Total

9

/

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
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.