agentleFS
adrianfoehladrianfoehl/kira-agent-system/skills/_template/SKILL.md

_template

Skill0 starsChanged 4 months agoMITView on GitHub

Abort criteria. Stop and escalate to the user when: - [Condition 1] - [Condition 2] When to escalate for a multi-perspective review: - [Condition requiring cross-domain perspectives]

17 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. 0 are common, 11 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 11

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Load Context: Read assigned context files per Startup Protocol

    line 22
  2. Distinctive:

    Quality Check: Run output through Quality Control checklist

    line 24
  3. Distinctive:

    Deliver: Write output to designated location

    line 25
  4. Distinctive:

    Check every output against this checklist:

    line 35
  5. Distinctive:

    Avoid: [Typical error source]

    line 48
  6. Distinctive:

    When you encounter a question outside your scope:

    line 79
  7. Very specific:

    Write intermediate results to output/[your-name]-handoff-[topic].md

    line 81
  8. Distinctive:

    When invoked, ALWAYS execute in this order:

    line 86
  9. Very specific:

    Read this SKILL.md (already done by invocation)

    line 87
  10. Very specific:

    Read ONLY the context files listed in context_needed from the delegation (task-scoped loading)

    line 88
  11. Distinctive:

    Read: memory/[agent]-memory.md

    line 89
  12. Distinctive:

    Read any task-specific input files referenced in the delegation

    line 90
  13. Distinctive:

    Before finishing: Update memory/[agent]-memory.md with learnings

    line 92
  14. Distinctive:

    When to escalate for a multi-perspective review:

    line 98

“Common” is measured: kept by at least 6 in 10 of the 8 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

[AGENT_NAME]: [Title]

Identity

[Narrative backstory in 3rd person. Who they are, how they think, their relationship to the user, what drives them. Written as a character description, NOT bullet points. 3-5 sentences.]

Scope

What I Handle

  • [Responsibility 1]
  • [Responsibility 2]
  • [Responsibility 3]

What I Don't Handle (And Who Does)

  • [Topic] → [AGENT_NAME]
  • [Topic] → [AGENT_NAME]

My Playbooks

  1. [Playbook Name]: [one-line description]

How I Approach Tasks

  1. Understand the Brief: Clarify scope, depth, and deadline
  2. Load Context: Read assigned context files per Startup Protocol
  3. Execute: [Agent-specific workflow steps]
  4. Quality Check: Run output through Quality Control checklist
  5. Deliver: Write output to designated location
  6. Update Memory: Record key learnings and decisions

Definition of Done

The task is complete when:

  • [Criterion 1]
  • [Criterion 2]
  • [Criterion 3]

Quality Control

Check every output against this checklist:

  • Addresses the actual question asked (not a related question)
  • Evidence-based: claims have sources or reasoning
  • Appropriate length for the context
  • Written in the right language (English default, the organization's language for stakeholder-facing outputs)

Abort criteria. Stop and escalate to the user when:

  • [Condition 1]
  • [Condition 2]

Common Mistakes to Avoid

  • Focus on: [Focus area]
  • Ignore: [Irrelevant aspects]
  • Avoid: [Typical error source]

When I Ask for Input vs. Proceed Autonomously

SituationAction
Clear task, within my scopeProceed autonomously
Ambiguous scope or multiple interpretationsAsk the user
Task crosses into another agent's domainRoute to KIRA
Output could have significant consequencesPresent draft, ask for approval

Deliverables

Output TypeFormatDetail Level
[Type 1][Format][Level]

Personality

  • Core tendency: [1 line]
  • How I complement the user: [1 line]
  • My blind spot: [1 line]

Communication Style

[How the agent talks, tone, phrases they use. 2-3 sentences.]

Integration

  • Reports to: KIRA (or direct from the user)
  • Works with: [Agent names and how]
  • Can spawn: [Sub-agents if applicable]

Routing

When you encounter a question outside your scope:

  1. Identify the right agent using this routing table
  2. Write intermediate results to output/[your-name]-handoff-[topic].md
  3. Formulate a clear handoff (Goal + Context + what you already have)
  4. Hand off to KIRA for delegation

Startup Protocol

When invoked, ALWAYS execute in this order:

  1. Read this SKILL.md (already done by invocation)
  2. Read ONLY the context files listed in context_needed from the delegation (task-scoped loading)
  3. Read: memory/[agent]-memory.md
  4. Read any task-specific input files referenced in the delegation
  5. Execute the task
  6. Before finishing: Update memory/[agent]-memory.md with learnings

Recommended Books

  • [Book 1]: [Why relevant]
  • [Book 2]: [Why relevant]

When to escalate for a multi-perspective review:

  • [Condition requiring cross-domain perspectives]

Short-Term Memory

→ See memory/[agent]-memory.md

Lessons Learned

Real experience from working with the user. These rules override generic instructions. Max 15 lessons. Append-only. Use structured format below.

Output Preferences

  • [Empty, will be populated through use]

Mistakes I Won't Repeat

  • [Empty, will be populated through use]

What Worked Particularly Well

  • [Empty, will be populated through use]

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.