CtrlK
BlogDocsLog inGet started
Tessl Logo

pi-share

Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history.

66

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 body is highly actionable with complete, executable commands and clear single-step usage, and it stays lean throughout. The main improvement opportunities are removing the duplicated URL/human-summary explanations and moving the session data schema into a reference file.

DimensionReasoningScore

Conciseness

The body is efficient and assumes competence, but the four supported URL forms are listed twice (intro and "When to Use") and the human-summary purpose is explained in both "When to Use" and "## Human Summary" — minor redundancy that could be trimmed.

4 / 5

Actionability

Every usage mode is given as a copy-paste-ready `node ... fetch-session.mjs` command with its flag, and the example section adds concrete executable `jq` pipelines that cover the common filtering cases.

5 / 5

Workflow Clarity

This is a simple, read-only, single-action skill: invoking one script with a clearly documented flag is unambiguous, "How It Works" explains the fetch/decode mechanism, and no destructive or batch operations exist that would require validation checkpoints.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers and no nested references, but ~40 lines of reference-style material (the SessionData interface, entry types, and content block types) are inlined in a 100+ line file rather than split into a one-level-deep reference file.

4 / 5

Total

18

/

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.

The description is concrete, action-oriented, and highly distinctive, with excellent domain-synonym coverage. Its main weakness is the missing explicit "Use when..." trigger clause, which leaves the "when" only weakly implied and caps completeness.

Suggestions

Append an explicit trigger clause such as: "Use when the user provides a pi-share/buildwithpi URL or pastes a raw gist ID."

Mention the gist-ID shorthand form (e.g., a bare 32-char hex ID or `#<gist_id>`) as a trigger so pasted IDs match.

Optionally name one more capability (e.g., human-centric session summaries) to close the coverage gap without adding length.

DimensionReasoningScore

Specificity

"Fetches gists, decodes embedded session data, and extracts conversation history" lists several concrete, specific actions with only minor gaps — the header/system-prompt/tools output modes and the --human-summary capability go unmentioned.

4 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by "from ... URLs", which caps completeness at 3.

3 / 5

Trigger Term Quality

Strong synonym coverage across all four domains ("shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev") plus "pi-share", "gists", and "session transcripts", but it never mentions the bare gist ID form a user might paste.

4 / 5

Distinctiveness Conflict Risk

The four named domains and the "pi-share" term define a clear niche with distinct triggers; virtually no other skill would match these URLs, so conflict risk is minimal.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
mitsuhiko/agent-stuff
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.