agentleFS
hssh8917hssh8917/cc-skills/skills/training-report/SKILL.md

training-report

Skill2 starsChanged 7 months agoMITView on GitHub

Produce a professional training/workshop report as a .docx file. Use this skill whenever the user mentions "training report", "workshop report", "compte rendu", "compte rendu de formation", "formation report", "debriefing a workshop", "write up a training session", "résumé de formation", or any request to document a training session, workshop, or onboarding event with individual participant feedback and recommendations. Also trigger when the user says things like "I just ran a workshop and need to write it up", "help me summarize what happened in my training session", or "I need to report back to management about a session I ran". Always use this skill — for short or long sessions, across any discipline (technical, soft skills, creative, compliance, onboarding, etc.) — whenever a structured written deliverable about a training event is needed.

1 other project uses a version of this, 1 of them edited.

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

24 rules. About 0 are common, 23 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈23

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If found: note it; load it at Step 6

    line 40
  2. Distinctive:

    If not found: warn the user — it is required to generate the final Word document and can be installed from Anthropic's official skill …

    line 41
  3. Distinctive:

    After Step 1, look for a humanizer skill matching the chosen language

    line 45
  4. Distinctive:

    If found: load it and apply it during the humanization pass in Step 5

    line 46
  5. Distinctive:

    If not found: tell the user once, then fall back to inline humanization rules (Step 5b).

    line 47
  6. Distinctive:

    Ask: "Did participants produce anything during the session?"

    line 105
  7. Distinctive:

    Ask: "Do you have specific observations for any individual participant?"

    line 127
  8. Distinctive:

    Individual Feedback is optional: Only write it if the trainer explicitly provides meaningful observations.

    line 137
  9. Distinctive:

    Ask: "What would you recommend to the direction/client to build on this session?"

    line 145
  10. Distinctive:

    Follow-up sessions (refresher, coaching, Q&A after a few weeks)

    line 152
  11. Distinctive:

    Ask: "Do you have any annexes to attach to the report?"

    line 161
  12. Distinctive:

    Ask: "May I include a closing note thanking the team for the invitation, and your contact details for future collaboration?

    line 181
  13. Very specific:

    If yes: collect name, email, phone.

    line 183
  14. Distinctive:

    Ask the user to confirm before it enters the document.

    line 195
  15. Distinctive:

    Ask: "Anything to adjust before I start the draft?"

    line 214
  16. Distinctive:

    Before presenting the draft, apply the humanizer skill (loaded in Step 0).

    line 222
  17. Distinctive:

    Do not present an un-humanized draft.

    line 231
  18. Distinctive:

    Don't fabricate details — only document what the trainer explicitly provided

    line 247
  19. Distinctive:

    Don't editorialize in General Observations — factual only

    line 248
  20. Distinctive:

    Don't write Individual Feedback unless explicitly provided — and stay diplomatic

    line 249
  21. Distinctive:

    Don't pad recommendations — 6 sharp ones beat 12 vague ones

    line 250
  22. Distinctive:

    Always include a Pacing recommendation in the Next Steps

    line 251
  23. Distinctive:

    Never generate the .docx mid-conversation — Markdown is the draft stage

    line 253
  24. Distinctive:

    Never skip an annex or image — embed, reference, or placeholder

    line 254

≈ “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

Training Report

Iterate the full report in Markdown first. Generate the .docx last, once, when the content is final. The .md is the canonical artifact; the .docx is a terminal derivative.

Discipline-agnostic: coding workshop, leadership seminar, safety training, onboarding, creative workshop — all apply equally.

Voice mode: this conversation may be conducted by voice. Transcription can introduce homophones, missing punctuation, or ambiguous proper nouns (names, company names, tool names). If any answer is unclear after transcription, ask a short clarifying question before moving on — do not guess.

Reference files

Load these files at the steps indicated. Do not load them all upfront.

FileLoad at
references/tone-of-voice.mdStep 1 (after language + audience confirmed)
references/markdown-draft.mdStep 5 (before writing the draft)
references/docx-generation.mdStep 6 (before generating the .docx)

Step 0 — Check dependencies

Before asking the user anything, verify skill availability.

docx skill (required for Step 6)

  • If found: note it; load it at Step 6
  • If not found: warn the user — it is required to generate the final Word document and can be installed from Anthropic's official skill library. Offer to proceed with the Markdown draft in the meantime.

Humanizer skill (recommended)

  • After Step 1, look for a humanizer skill matching the chosen language
  • If found: load it and apply it during the humanization pass in Step 5
  • If not found: tell the user once, then fall back to inline humanization rules (Step 5b). Suggest installing a humanizer skill for the chosen language.

Step 1 — Language & audience

Ask:

  1. "In what language should I write the report? (French / English / other)"
  2. "Who is the primary reader? (executive / HR / direct management / external client / internal archive)"

Then load references/tone-of-voice.md and apply its guidance throughout.

Step 2 — Template

Ask:

"Do you have a Word (.docx) template for this report? (company header/footer, logo, branded fonts, color scheme)"

  • Yes → ask them to upload it; use it as the base at Step 6 (unpack/inject/repack)
  • No → proceed with a clean document; ask for a brand color before defaulting to blue #2E75B6

Step 3 — Interview

Conduct a structured interview in batches. Wait for answers before moving on. Extract what the user already told you from the conversation before asking.

Batch A — Session metadata

  • Trainer name and role
  • Date, location, company/team name
  • Duration
  • Total number of participants
  • Confirm or refine: who is the document for?

Batch B — Session context

  • Stated goal of the training
  • Subject, topic, tool, or material used as practical support
  • Any rules or constraints set at the start
  • Materials, accounts, licenses, or equipment provided to participants

Batch C — Starting levels

  • Distribution of familiarity across the group (any beginners? any experts?)
  • Notable outliers at either end

Batch D — Session walkthrough

Walk through the session step by step. For each step:

  • Objective
  • What participants actually did
  • Materials, tools, or exercises involved
  • First exposure to this concept or not
  • How it landed; any difficulties

Probe until complete: "What happened next?", "Did anything go differently than planned?", "Were there any pivots?"

Batch E — Deliverables

Ask: "Did participants produce anything during the session?"

Probe for:

  • Documents, files, diagrams, prototypes, or any output created during exercises
  • Collaborative work produced as a group
  • Individual work produced autonomously
  • Anything left incomplete or started but not finished

These may appear in the Annexes and/or be referenced in the Session Walkthrough.

Batch F — General observations

  • Overall energy and engagement of the group
  • Any incidents, surprises, or notable moments
  • Schedule: did it hold, or were sections cut/extended?
  • Logistical issues (room, materials, setup)

General Observations is optional. If the trainer has nothing notable to add beyond the walkthrough, skip this section entirely.

Batch G — Individual feedback

Ask: "Do you have specific observations for any individual participant?"

For each named participant, extract:

  • Role or background
  • Starting level
  • Behavior/engagement (positive and negative)
  • Notable evolution, breakthrough, or resistance
  • How they ended the session

Individual Feedback is optional. Only write it if the trainer explicitly provides meaningful observations. Do not prompt for feedback on every participant.

Be diplomatic. Describe behaviors, not character. Name problems factually; do not editorialize. When writing for an external client about a team you don't know, consider whether naming individuals is appropriate at all.

See references/tone-of-voice.md — Diplomatic framing section.

Batch H — Recommendations & next steps

Ask: "What would you recommend to the direction/client to build on this session?"

Probe for:

  • Resources and access to provide (licenses, books, platforms, communities)
  • Practices to anchor in daily work
  • What to pace carefully — basics before advanced material
  • Follow-up sessions (refresher, coaching, Q&A after a few weeks)
  • Assessment and validation (quiz, practical challenge, peer review, checklist)
  • Knowledge-sharing rituals (Slack/Teams channel, recurring meeting, Loom demos, buddy system, monthly show-and-tell)
  • Management involvement (protect practice time, 1:1 check-ins, celebrate wins)
  • External resources (books, courses, certifications) for self-driven participants
  • Specific warnings or caveats for management

Batch I — Annexes

Ask: "Do you have any annexes to attach to the report?"

Annexes can include:

  • Photos from the session
  • Satisfaction survey results (NPS, ratings, verbatim comments)
  • Slides or handouts distributed during the session
  • Work produced by participants (exercises, prototypes, documents, diagrams)
  • Reference documents used during the session
  • Any other supporting material

For each annex:

  • Image → attempt auto-embed at Step 6
  • File (PDF, slides, spreadsheet) → reference in the Annexes section; do not embed
  • Survey data → synthesize in Step 4, then include as a dedicated section in the doc
  • Participant deliverable → reference in the relevant Walkthrough step AND in Annexes

Batch J — Closing & contact

Ask: "May I include a closing note thanking the team for the invitation, and your contact details for future collaboration? (email + phone)"

If yes: collect name, email, phone. The closing is written in the document language, personal in tone, brief. See references/markdown-draft.md — Closing paragraph section.

Step 4 — Feedback synthesis (if survey data provided)

Produce a synthesis in the conversation before drafting:

  • Overall score / NPS
  • Rating distribution
  • Top 3 positive themes
  • Top 3 areas for improvement
  • Any outlier responses

Ask the user to confirm before it enters the document.

Step 4b — Confirm outline

Here's what I'll draft:
1. Context
2. Starting Levels
3. Session Walkthrough (N steps)
4. General Observations         [optional — include if trainer provided content]
5. Participant Satisfaction     [only if survey data provided]
6. Individual Feedback          [optional — include if trainer provided feedback]
7. Recommendations & Next Steps
8. Annexes                      [only if annexes provided]
[Closing + contact]

Language: [language] | Audience: [target] | Template: [yes/no]

Ask: "Anything to adjust before I start the draft?"

Step 5 — Markdown draft

Load references/markdown-draft.md before writing. It contains the full section-by- section writing guide, Markdown limitations, HTML table workarounds, and closing paragraph guidance.

Humanization pass

Before presenting the draft, apply the humanizer skill (loaded in Step 0). If no humanizer skill is available, apply these rules inline:

  • Cut all AI throat-clearing openers and sentence starters
  • Cut adjective doublets — pick the more precise word
  • Replace passive voice with active wherever natural
  • Replace vague praise or criticism with specific behaviors or facts
  • Short sentences over long ones
  • Adapt to the document language (see references/tone-of-voice.md)

Do not present an un-humanized draft.

Iteration loop

Present the draft inline in the conversation. Let the user lead. Update the .md file for every change. One canonical file, no versions. Only move to Step 6 when the user explicitly confirms the content is final.

Step 6 — Final .docx generation

Load references/docx-generation.md and the docx skill before starting.

This step runs once. It is terminal: if the user requests changes after the .docx is generated, update the .md and regenerate from scratch.

Deliver both files. If the environment supports inline file delivery (e.g. present_files on Claude.ai), use it. Otherwise, print the absolute paths to both files.

Pitfalls

  • Don't fabricate details — only document what the trainer explicitly provided
  • Don't editorialize in General Observations — factual only
  • Don't write Individual Feedback unless explicitly provided — and stay diplomatic
  • Don't pad recommendations — 6 sharp ones beat 12 vague ones
  • Always include a Pacing recommendation in the Next Steps
  • This skill is not developer-specific — adapt vocabulary to the discipline
  • Never generate the .docx mid-conversation — Markdown is the draft stage
  • Never skip an annex or image — embed, reference, or placeholder

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.