CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-academy-stargazers

Look up who has starred the microsoft/agent-academy repository on GitHub. Use this skill whenever the user wants to check stargazers, see if a specific GitHub user has starred the repo, or retrieve an up-to-date list of stargazers. Trigger whenever the user says "who starred agent academy", "check stargazers", "has <user> starred the repo", or asks anything about the repository's stargazer list. This skill uses the GitHub CLI to fetch stargazers via the GitHub API and saves the results to a local JSON file. It will install prerequisites if needed.

69

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 clear, well-structured single-file skill with an unambiguous flow and good failure handling. Its main weaknesses are redundancy — the gh install/auth and pagination/jq guidance is repeated across Prerequisites, Skill Flow, and Rules — and the absence of the full assembled gh api command line, which keeps actionability and conciseness in the middle-upper range.

Suggestions

Write out the complete fetch command once, e.g. `gh api --paginate repos/microsoft/agent-academy/stargazers --jq '[.[] | {login, type, url}]' > temp/stargazers.json`, instead of describing its flags across separate steps and rules.

Remove the duplicated install/auth instructions from the Rules section and keep them only in Prerequisites (the Skill Flow already points back to it), eliminating three restatements of the same guidance.

Add a light post-fetch checkpoint, e.g. verify the saved file is non-empty valid JSON before reporting the count, to close the workflow's only validation gap.

DimensionReasoningScore

Conciseness

The body is mostly efficient but repeats the same instructions in three places: the Prerequisites section, Skill Flow step 1 ("verify the gh CLI is installed and authenticated"), and Rules bullets 5–6 restate the install/auth guidance; Rules 1–2 likewise restate the --paginate and --jq instructions from Skill Flow step 2. Consolidating these into one place would tighten the skill noticeably, fitting the anchor "mostly efficient but includes some unnecessary explanation or could be tightened".

3 / 5

Actionability

Concrete commands are given (gh --version, gh auth status, --jq '[.[] | {login, type, url}]', per_page=100) and each flow step is executable in intent, but the actual full command — including the endpoint path repos/microsoft/agent-academy/stargazers — is never written out as a copy-paste line. That is a minor gap consistent with "mostly executable guidance; concrete code or commands with minor gaps" rather than a 3, since every parameter and filter is still specified.

4 / 5

Workflow Clarity

The five-step flow is clearly sequenced with an explicit pre-flight gate ("Do not proceed with the rest of the skill until both checks pass") and failure handling ("If the API request fails... report the error clearly and do not write a partial or empty file"). It falls short of anchor 5 only because there is no post-fetch validation step (e.g., verifying the saved JSON parsed and has a sensible count before reporting), and short of the destructive/batch cap is not triggered since the operation is read-only plus one file write.

4 / 5

Progressive Disclosure

This is a simple, single-purpose skill (~40 lines) with no bundle files (references/, scripts/, assets/ are all absent), so nothing needs to be split out. It is organized into three well-labeled sections (Prerequisites, Skill Flow, Rules) with no nested references, matching the rubric's exception that short single-file skills with well-organized sections score 5.

5 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities in third-person/imperative voice, includes verbatim natural trigger phrases, names the tooling and output, and is tightly scoped to one repo so conflict risk is negligible. The only nit is mild redundancy between the "Use this skill whenever..." and "Trigger whenever..." sentences, which restates the trigger guidance twice, but this does not affect any dimension's anchors.

DimensionReasoningScore

Specificity

Multiple concrete actions are explicitly stated: "Look up who has starred the microsoft/agent-academy repository", "check if a specific GitHub user has starred the repo", "retrieve an up-to-date list", "uses the GitHub CLI to fetch stargazers via the GitHub API and saves the results to a local JSON file", and "install prerequisites if needed" — comprehensive coverage of what the skill does.

5 / 5

Completeness

Both halves are explicit: the "what" (lookup, user check, list retrieval, gh CLI/API, JSON output, prerequisite install) and the "when" ("Use this skill whenever the user wants to check stargazers... Trigger whenever the user says..."). This matches the anchor-5 example structure of concrete what + explicit trigger phrases.

5 / 5

Trigger Term Quality

Natural trigger phrases are quoted directly: "who starred agent academy", "check stargazers", "has <user> starred the repo", plus the catch-all "asks anything about the repository's stargazer list". These are exactly the phrasings a user would naturally say, with synonyms (stargazers / starred / star) covered.

5 / 5

Distinctiveness Conflict Risk

The description is pinned to a single named repository (microsoft/agent-academy) and a single well-defined operation (stargazer lookup), giving it a clear niche with distinct triggers and minimal overlap with other skills. Anti-drift check: no neighboring anchor (4, "minor overlap risk") fits better since nothing here could plausibly fire for a different skill.

5 / 5

Total

20

/

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
microsoft/agent-academy
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.