agentleFS
patonkikhpatonkikh/APES/skills/_template/skill.md

skill-name

Skill3 starsChanged 4 months agoMITView on GitHub

[One sentence: what artifact this skill produces]. Use when [trigger scenario 1], [trigger scenario 2], or [domain keywords].

39 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use git-workflow and frontend-design.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Microsoft AzureSkill

    git-workflow

    Squad branching model: dev-first workflow with insiders preview channel

    Also in 3 projects that use this

  • BlockSkill

    frontend-design

    Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 17 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If any required input is missing, stop and request it explicitly.

    line 33
  2. Distinctive:

    Run the Validation checklist.

    line 49
  3. Distinctive:

    Before delivering the result, verify:

    line 71
  4. Distinctive:

    Use concrete examples from the user's domain, not generic placeholders.

    line 96
  5. Distinctive:

    Prefer tables and structured lists over prose paragraphs.

    line 97

“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
skill.md

[Skill Name]

Purpose

[One sentence: what engineering task this Skill completes and what artifact it produces.]

Input: [Required inputs from user or prior Skills]
Output: [Named artifact, e.g. "Validated Problem Statement document"]
Examples: See examples.md for worked input/output (optional).


Workflow

Step 1: Gather inputs

Collect the following from the user or context:

  • [Input 1]
  • [Input 2]
  • [Input 3]

If any required input is missing, stop and request it explicitly. Do not assume values.

Step 2: Analyze

[Describe analysis actions: map assumptions, identify gaps, compare alternatives.]

Step 3: Apply methodology

[Apply the named methodology: e.g. JTBD framing, RICE scoring, INVEST criteria.]

Step 4: Draft output

Produce the result using the Output Structure below.

Step 5: Validate

Run the Validation checklist. Fix all failures before presenting the final result.

Step 6: Recommend next steps

Suggest Skills from the Next Skills section based on the current outcome.


Decision Rules

ConditionAction
Required input is missingStop; list missing items; ask user
Input contains contradictionsSurface contradictions; ask user to resolve before proceeding
Multiple valid approaches existPresent options with trade-offs; ask user to choose
Result fails ValidationRevise and re-validate; do not deliver incomplete output
Scope exceeds single taskSplit into parts; complete only this Skill's scope

Validation

Before delivering the result, verify:

  • All required inputs were explicitly provided or confirmed
  • Output follows the Output Structure completely
  • No contradictions remain unresolved
  • No ambiguous terms without definition
  • Result is actionable without additional unstated assumptions
  • [Skill-specific criterion 1]
  • [Skill-specific criterion 2]

Anti-patterns

  • Assuming unstated context — inventing user goals, market data, or constraints not provided.
  • Role-play filler — generic advice not tied to the methodology.
  • Scope creep — implementing tasks that belong to Next Skills (e.g. writing a full PRD when only problem statement is requested).
  • Vague output — labels without measurable criteria ("improve UX", "increase engagement").
  • Skipping validation — delivering draft without running the checklist.

Best Practices

  • State assumptions explicitly in a dedicated section when user confirms them.
  • Use concrete examples from the user's domain, not generic placeholders.
  • Prefer tables and structured lists over prose paragraphs.
  • Reference the methodology by name and apply it consistently.
  • Flag risks and open questions in a separate section rather than hiding them.
  • Load examples.md when the user needs a reference output shape.

Output Structure

# [Artifact Title]

## Context
- **Source inputs:** [list]
- **Assumptions:** [list or "none"]

## [Main Section 1]
[Content]

## [Main Section 2]
[Content]

## Open Questions
- [ ] [Question requiring user input]

## Risks
| Risk | Impact | Mitigation |
|------|--------|------------|
| ... | ... | ... |

Next Skills

OutcomeRecommended Skill
[Condition A][category]/[skill-name]
[Condition B][category]/[skill-name]
Default next step[category]/[skill-name]

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.