agentleFS
Andamio-PlatformAndamio-Platform/coach/skills/draft-slts/SKILL.md

draft-slts

Skill6 starsChanged 8 months agoMITView on GitHub

Draft Student Learning Targets for a new course or module.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 9 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    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:

    Before drafting SLTs, read the knowledge base for patterns that should influence your work.

    line 27
  2. Distinctive:

    Prefer verbs with high success_count

    line 31
  3. Very specific:

    Always read knowledge/research/slt-research-report.md for full research context before drafting.

    line 55
  4. Distinctive:

    Every SLT must follow this structure:

    line 59
  5. Distinctive:

    Use verbs that match the cognitive level appropriate for the content:

    line 70
  6. Distinctive:

    Never use these unmeasurable verbs:

    line 85
  7. Distinctive:

    One capability per SLT: If an SLT has "and" connecting two different skills, split it.

    line 117
  8. Distinctive:

    Make it assessable: Ask: "Could a teacher design an assignment to verify this?" If not, rewrite.

    line 119
  9. Distinctive:

    Mark optional modules: If a module is optional/advanced, note it in the title: "Module 4: [Title] (Optional)"

    line 129
  10. Distinctive:

    Before outputting, verify each SLT:

    line 133
  11. Very specific:

    Run /assess-slts to get quality feedback

    line 147
  12. Very specific:

    Create 00-course.md with lesson types and assignments based on the finalized SLTs

    line 148

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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: Draft Student Learning Targets

Description

Generates well-formed Student Learning Targets (SLTs) for a course or module based on topic, audience, and learning goals. Follows education research best practices and Andamio protocol conventions.

Instructions

Path Resolution

Resolve file paths based on your execution context:

  • Plugin context (${CLAUDE_PLUGIN_ROOT} is set): Read knowledge from ${CLAUDE_PLUGIN_DATA}/knowledge/ (user data), falling back to ${CLAUDE_PLUGIN_ROOT}/knowledge/ (seed data). Read research from ${CLAUDE_PLUGIN_ROOT}/knowledge/research/.
  • Clone/symlink context (default): Read knowledge from knowledge/ relative to the project root (research is at knowledge/research/).

Pre-Execution Knowledge Check

Before drafting SLTs, read the knowledge base for patterns that should influence your work. If any knowledge file does not exist, skip it and proceed without prior patterns — note "No prior data available" in output.

  1. Read knowledge/slt-patterns/verb-bank.yaml
    • Note effective verbs by Bloom's level
    • Prefer verbs with high success_count
  2. Read knowledge/slt-patterns/quality-issues.yaml
    • Note problematic patterns to avoid
    • Especially avoid patterns with high frequency
  3. Surface knowledge to user (if relevant patterns exist):
    ### Tips from Previous Courses
    
    **Effective verbs at this level:** compare, distinguish, implement (12 successes)
    **Patterns to avoid:** "understand X" (flagged 8 times), task-focused phrasing

The user will describe a course or module they want to create. Gather the following information (ask if not provided):

  1. Topic: What is the course/module about?
  2. Audience: Who are the learners? What's their background?
  3. Learning goals: What should learners be able to do after completing this?
  4. Module count: How many modules? (Default: 3-4)
  5. SLTs per module: How many SLTs per module? (Default: 2-4)

Always read knowledge/research/slt-research-report.md for full research context before drafting.

The SLT Formula

Every SLT must follow this structure:

I can + [measurable verb] + [specific outcome] + [observable evidence/context]

Examples:

  • Weak: "I can understand blockchain" (unmeasurable, vague)
  • Better: "I can explain what a blockchain is" (measurable, but no evidence)
  • Strong: "I can compare a Portable Access Token to a traditional platform account by identifying at least two differences in ownership, portability, and revocability" (measurable verb, specific outcome, observable evidence)

Verb Selection (Bloom's Taxonomy)

Use verbs that match the cognitive level appropriate for the content:

LevelVerbsWhen to Use
Rememberlist, name, identify, recallFoundational facts, terminology
Understandexplain, describe, summarize, compareConceptual understanding
Applyuse, demonstrate, implement, executeProcedural skills
Analyzedistinguish, examine, compare, contrastBreaking down complex topics
Evaluatejudge, justify, critique, assessMaking judgments
Createdesign, construct, develop, produceBuilding something new

Progression principle: Early modules should include more Remember/Understand/Apply. Later modules can include Analyze/Evaluate/Create.

Verbs to Avoid

Never use these unmeasurable verbs:

  • understand, know, learn, appreciate, be aware of, become familiar with

These cannot be assessed. Replace with specific, observable actions.

Output Format

Generate SLTs in this exact format:

# SLTs: [Course Name]

## Module 1: [Module Title]

- 1.1: I can [verb] [specific outcome] [evidence/context].
- 1.2: I can [verb] [specific outcome] [evidence/context].
- 1.3: I can [verb] [specific outcome] [evidence/context].

## Module 2: [Module Title]

- 2.1: I can [verb] [specific outcome] [evidence/context].
- 2.2: I can [verb] [specific outcome] [evidence/context].

## Module 3: [Module Title]

- 3.1: I can [verb] [specific outcome] [evidence/context].
- 3.2: I can [verb] [specific outcome] [evidence/context].
- 3.3: I can [verb] [specific outcome] [evidence/context].

Guidelines

  1. One capability per SLT. If an SLT has "and" connecting two different skills, split it.
  2. Make it assessable. Ask: "Could a teacher design an assignment to verify this?" If not, rewrite.
  3. Write for the learner. SLTs should make learners curious, not anxious. Name tools and frameworks, but leave implementation details to the lessons.
  4. Build progression. Module 1 SLTs should be achievable early. Later modules can build on earlier ones.
  5. 2-4 SLTs per module is ideal. More than 5 per module suggests the module should be split.
  6. Consider the assignment. Each module needs one assignment that can assess all its SLTs. If the SLTs don't fit a coherent assignment, reorganize.
  7. Mark optional modules. If a module is optional/advanced, note it in the title: "Module 4: [Title] (Optional)"

Quality Checklist

Before outputting, verify each SLT:

  • Starts with "I can"
  • Uses a measurable verb (not understand/know/learn)
  • Has a specific outcome (not vague)
  • Includes observable evidence or context
  • Can be assessed through an assignment
  • Is appropriate for the stated audience
  • Fits the cognitive progression (Bloom's levels build across modules)

After Drafting

Suggest the user:

  1. Review and refine the SLTs with their team
  2. Run /assess-slts to get quality feedback
  3. Create 00-course.md with lesson types and assignments based on the finalized SLTs

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.

Reviews can't be read right now.

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.