CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

composite-actions

Generate, review, secure, and test composite GitHub Actions following best practices — full repo scaffold, interview-driven generation, PR creation on existing repos, SHA pinning, secrets-as-inputs, job summaries, and actionlint validation.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/composite-actions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

A highly actionable, well-organized multi-mode skill body with concrete commands, templates, and tiered review criteria. Its main weaknesses are the missing post-rewrite validation in the batch migrate (and secure) flows, which caps workflow clarity, and a bundle that ships none of the reference or example files the body cites while inlining template content that belongs in those files.

Suggestions

Add a validation step to migrate mode after rewriting callers — e.g. run actionlint on the modified workflow files and verify the extracted action's test workflow passes — and similarly verify action.yml after secure mode's in-place fixes.

Move the README template, Marketplace publish checklist, and Feather icon/color catalogs into reference files (e.g. references/templates.md, references/publish.md) linked from SKILL.md, keeping the body a lean overview of the six modes.

Ship the cited bundle files (references/composite-actions.md and the eight examples/github-actions/composite-actions/* directories) or remove the citations, since every referenced path currently resolves to nothing.

DimensionReasoningScore

Conciseness

The ~565-line body is dense and operational — interview questions, exact gh/git commands, act flags, and yq/actionlint specifics — with almost no explanation of concepts Claude already knows. Not a 5 because verbatim templates (the 70-line README markdown block) and data catalogs (the 40-item Feather icon list at the publish section) sit inline and could be trimmed or moved to reference files.

4 / 5

Actionability

Mostly copy-paste-ready: the PR-creation bash sequence, act test commands, dependabot.yml, the safe/unsafe injection YAML pair, and report formats are executable. Not a 5 because the two central artifacts — action.yml and the test workflow — are given as property checklists and bullet descriptions rather than a complete example, leaving minor gaps.

4 / 5

Workflow Clarity

Sequences are well ordered (generate's 9 interview steps with confirmations at steps 1, 4, and 9; secure's numbered 1-6 fixes; publish's step 1-4 checklist), but the migrate mode performs a batch rewrite of multiple caller workflows ("Rewrite callers — replace the extracted steps in each workflow") with no verification step afterwards, and secure mode's in-place edits are only reported, not validated. The missing validation for these batch/destructive operations caps workflow clarity at 3 per the judging guidelines.

3 / 5

Progressive Disclosure

Structure is good (clean ## Mode sections, a clearly signaled "Full documentation: references/composite-actions.md" plus 8 example paths), but the bundle contains no references/, scripts/, or assets/ directories, so every cited reference and example path dangles. Additionally, content that belongs in separate files — the full README template, the Marketplace publish checklist, and icon/color catalogs — is inlined, fitting the anchor-3 pattern of references present but content that should be separate kept inline.

3 / 5

Total

14

/

20

Passed

Description

70%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.

A strong, concrete description that names specific capabilities in a distinct niche, but it lacks any explicit "Use when" trigger guidance and under-represents the skill's actual mode coverage (migrate and publish are undocumented). The actionlint claim also slightly overstates what the body prescribes for action.yml (it mandates yq for action.yml and actionlint only for workflows).

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to create, audit, or harden a composite GitHub Action, or mentions action.yml, unpinned uses:, or extracting duplicate workflow steps into a reusable action."

Mention the migrate and publish modes (or remove them from the body) so the description's capability list matches the skill's actual scope.

Align the "actionlint validation" claim with the body's guidance — yq validates action.yml while actionlint covers the generated workflows.

DimensionReasoningScore

Specificity

Enumerates concrete actions — "Generate, review, secure, and test composite GitHub Actions", "full repo scaffold, interview-driven generation, PR creation on existing repos, SHA pinning, secrets-as-inputs, job summaries, and actionlint validation" — which is well beyond the anchor-3 "1-2 concrete actions". Not a 5 because the body supports six modes (generate, review, secure, test, migrate, publish) while the description covers only four, leaving minor coverage gaps.

4 / 5

Completeness

The "what" is explicit and detailed, but the description contains no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" is clear and specific, unlike the vague-only anchor.

3 / 5

Trigger Term Quality

Good natural keyword coverage: users would plausibly say "generate", "review", "secure", "test", "composite GitHub Actions", "SHA pinning", "actionlint". Not a 5 because common variations like "action.yml", "reusable action", "harden", "pin actions", or "marketplace" are absent, so a few natural terms are missing.

4 / 5

Distinctiveness Conflict Risk

"composite GitHub Actions" with "SHA pinning, secrets-as-inputs, job summaries" carves out a clear, narrow niche that is distinct from generic workflow-generation or linting skills, with minimal conflict risk. The composite-action qualifier is repeated and unambiguous, matching the anchor-5 example's specificity.

5 / 5

Total

16

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (575 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

nitinjain999/platform-skills

Path

skills/composite-actions/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.