feat: fitness-instructor skill package v0.1.0

2026-08-14 18:49:24 +02:00
commit 6cca8198e3
10 changed files with 1166 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — fitness-instructor
+
+Where the content of this skill package comes from, counted by
+content items (tasks, competences, tools, evidence entries, curated
+knowledge). Rendered live by Gitea:
+
+```mermaid
+%%{init: {'theme':'base','themeVariables':{'pie1':'#f9a825','pie2':'#1e88e5','pie3':'#ff355e','pie4':'#d97757','pie5':'#8e24aa','pieOuterStrokeWidth':'0px','pieSectionTextColor':'#fff'}}}%%
+pie showData
+    title Content sources — fitness-instructor
+    "ESCO (occupation & competences)" : 25
+    "O*NET (tasks & tools)" : 60
+    "Job boards (market evidence)" : 90
+    "Anthropic official Claude skills" : 5
+    "External AI skill packs (mapped)" : 186
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 25 | 6.8 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 60 | 16.4 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 90 | 24.6 % | references/market.md (full report) + "Market evidence" headline sections |
+| Wikipedia & AI expert curation | 0 | 0.0 % | glossary, literature, usecases, intake, quality, evals/ |
+| Anthropic official Claude skills | 5 | 1.4 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 186 | 50.8 % | references/ai-skills.md (per-source attribution inside) |
+| Stack Exchange practitioner Q&A (CC-BY-SA) | 0 | 0.0 % | references/practitioner-qa.md (per-entry attribution inside) |
+
+Licensing: O*NET (USDOL/ETA, CC BY 4.0) · ESCO (© European Union) ·
+job-ad evidence via official APIs (JSearch/Adzuna) · Wikipedia content
+paraphrased with source URLs — never copied · external AI skills are
+linked, not copied (Apache-2.0/MIT/source-available, see ai-skills.md).
--- a/SKILL.md
+++ b/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: fitness-instructor
+description: "Occupational skill for the role 'fitness instructor' (also: swimming instructor, fitness class instructor, aqua fitness instructor, indoor cycling trainer, fitness specialist, water aerobics instructor). Use when the user asks for typical fitness instructor work such as: typical fitness instructor responsibilities"
+---
+
+# Fitness Instructor
+
+Fitness instructors build fitness participation of new and existing members through fitness experiences that meet their needs. They deliver fitness instruction to individuals, with the use of equipment, or to a group, through fitness classes. Both individual and group instructors have the purpose of promoting and delivering safe and effective exercise. Depending on the specific situation, some additional knowledge, skills and competences may be required.
+
+## Core workflow
+
+
+## How to use this skill
+
+- Read [references/profile.md](references/profile.md) for the occupation profile and scope.
+- Consult [references/tasks.md](references/tasks.md) for the full task and activity inventory.
+- Check [references/skills.md](references/skills.md) for essential vs. optional competences.
+- Check [references/tools.md](references/tools.md) for the software commonly used in this role.
+- See [references/ai-skills.md](references/ai-skills.md) — matched external AI agent skills (per-source attribution).
+
+## Key competences (essential)
+
+- adapt fitness exercises
+- analyse personal fitness information
+- assess physical conditions of clients
+- collect client fitness information
+- correct fitness customers
+- correct potentially harmful movements
+- identify customer objectives
+- integrate exercise science to the design of the programme
+- maintain the exercise environment
+- motivate fitness clients
+- participate in training sessions
+- promote fitness customer referral
+- promote healthy fitness environment
+- promote healthy lifestyle
+- provide fitness customer care
+
+## Hot technologies
+
+- Intuit QuickBooks
+- Microsoft Excel
+- Microsoft Office software
+- Microsoft Outlook
+- Microsoft PowerPoint
+- Microsoft Word
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/c784c2db-e636-429f-8492-3191790a58d7), O*NET 30.3 (39-9031.00, manual nearest match). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,292 @@
+{
+  "name": "fitness-instructor",
+  "title": "fitness instructor",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/c784c2db-e636-429f-8492-3191790a58d7",
+    "esco_code": "3423.2",
+    "isco_group": "3423",
+    "onet_soc": "39-9031.00",
+    "crosswalk_match": "manual nearest via ISCO 3423 (Exercise Trainers and Group Fitness Instructors)"
+  },
+  "sources": [
+    {
+      "name": "ESCO",
+      "version": "1.2.1",
+      "url": "https://esco.ec.europa.eu/"
+    },
+    {
+      "name": "O*NET",
+      "version": "30.3",
+      "url": "https://www.onetcenter.org/",
+      "license": "CC BY 4.0"
+    }
+  ],
+  "attribution": "This package includes information from the O*NET Database (v30.3) by the U.S. Department of Labor, Employment and Training Administration (USDOL/ETA), CC BY 4.0. skillfactor is not endorsed by USDOL/ETA. ESCO data (v1.2.1) (c) European Union, used per the ESCO download conditions: https://esco.ec.europa.eu/en/use-esco/download",
+  "counts": {
+    "tasks": 0,
+    "dwas": 0,
+    "skills_essential": 18,
+    "skills_optional": 6,
+    "software": 0
+  },
+  "enrichment_ai_skills": {
+    "generated": "2026-07-14",
+    "method": "deterministic mapping (ISCO prefix + title/competence keywords)",
+    "sources": {
+      "anthropics/skills": {
+        "repo": "https://github.com/anthropics/skills",
+        "commit": "f6656c1",
+        "license": "Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available \u2014 see the LICENSE.txt in the upstream skill folder",
+        "skills": 2
+      },
+      "Orchestra-Research/AI-research-SKILLs": {
+        "repo": "https://github.com/Orchestra-Research/AI-research-SKILLs",
+        "commit": "773a529",
+        "license": "MIT",
+        "skills": 5
+      },
+      "zechenzhangAGI/AI-research-SKILLs": {
+        "repo": "https://github.com/zechenzhangAGI/AI-research-SKILLs",
+        "commit": "773a529",
+        "license": "MIT",
+        "skills": 5
+      },
+      "Devin-AXIS/iPolloWork": {
+        "repo": "https://github.com/Devin-AXIS/iPolloWork",
+        "commit": "5107542",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 4
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 3
+      },
+      "muratcankoylan/Agent-Skills-for-Context-Engineering": {
+        "repo": "https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering",
+        "commit": "c578e85",
+        "license": "MIT",
+        "skills": 2
+      },
+      "jeremylongshore/claude-code-plugins-plus-skills": {
+        "repo": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills",
+        "commit": "e112938a",
+        "license": "MIT",
+        "skills": 5
+      },
+      "nexu-io/open-design": {
+        "repo": "https://github.com/nexu-io/open-design",
+        "commit": "4b66023",
+        "license": "Apache-2.0",
+        "skills": 12
+      },
+      "mohitagw15856/pm-claude-skills": {
+        "repo": "https://github.com/mohitagw15856/pm-claude-skills",
+        "commit": "876fa30",
+        "license": "MIT",
+        "skills": 4
+      },
+      "AlpacaLabsLLC/skills-for-architects": {
+        "repo": "https://github.com/AlpacaLabsLLC/skills-for-architects",
+        "commit": "4476576",
+        "license": "MIT",
+        "skills": 2
+      },
+      "mattpocock/skills": {
+        "repo": "https://github.com/mattpocock/skills",
+        "commit": "66898f6",
+        "license": "MIT",
+        "skills": 1
+      },
+      "basicmachines-co/basic-memory": {
+        "repo": "https://github.com/basicmachines-co/basic-memory",
+        "commit": "53da71c",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 2
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 6
+      },
+      "mcollina/skills": {
+        "repo": "https://github.com/mcollina/skills",
+        "commit": "5b2a813",
+        "license": "MIT",
+        "skills": 1
+      },
+      "JasonColapietro/suede-creator-skills": {
+        "repo": "https://github.com/JasonColapietro/suede-creator-skills",
+        "commit": "0dc2aef",
+        "license": "MIT",
+        "skills": 1
+      },
+      "ruvnet/claude-code-flow": {
+        "repo": "https://github.com/ruvnet/claude-code-flow",
+        "commit": "73914bd",
+        "license": "MIT",
+        "skills": 1
+      },
+      "ruvnet/ruflo": {
+        "repo": "https://github.com/ruvnet/ruflo",
+        "commit": "73914bd",
+        "license": "MIT",
+        "skills": 1
+      },
+      "ljagiello/ctf-skills": {
+        "repo": "https://github.com/ljagiello/ctf-skills",
+        "commit": "d19f35f",
+        "license": "MIT",
+        "skills": 1
+      },
+      "affaan-m/everything-claude-code": {
+        "repo": "https://github.com/affaan-m/everything-claude-code",
+        "commit": "ed38744",
+        "license": "MIT",
+        "skills": 1
+      },
+      "foryourhealth111-pixel/Vibe-Skills": {
+        "repo": "https://github.com/foryourhealth111-pixel/Vibe-Skills",
+        "commit": "34429a8",
+        "license": "Apache-2.0",
+        "skills": 2
+      },
+      "OpenRaiser/NanoResearch": {
+        "repo": "https://github.com/OpenRaiser/NanoResearch",
+        "commit": "7144364",
+        "license": "MIT",
+        "skills": 1
+      },
+      "nexscope-ai/eCommerce-Skills": {
+        "repo": "https://github.com/nexscope-ai/eCommerce-Skills",
+        "commit": "56f3288",
+        "license": "MIT",
+        "skills": 2
+      },
+      "hoangsonww/Claude-Code-Agent-Monitor": {
+        "repo": "https://github.com/hoangsonww/Claude-Code-Agent-Monitor",
+        "commit": "8f87ce1",
+        "license": "MIT",
+        "skills": 1
+      },
+      "gooseworks-ai/goose-skills": {
+        "repo": "https://github.com/gooseworks-ai/goose-skills",
+        "commit": "94ec916",
+        "license": "no explicit license \u2014 referenced by link only",
+        "skills": 1
+      },
+      "alirezarezvani/claude-skills": {
+        "repo": "https://github.com/alirezarezvani/claude-skills",
+        "commit": "0241f43",
+        "license": "MIT",
+        "skills": 1
+      },
+      "mxyhi/ok-skills": {
+        "repo": "https://github.com/mxyhi/ok-skills",
+        "commit": "94707b6",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "pedrohcgs/claude-code-my-workflow": {
+        "repo": "https://github.com/pedrohcgs/claude-code-my-workflow",
+        "commit": "be53c12",
+        "license": "MIT",
+        "skills": 1
+      },
+      "HeshamFS/materials-simulation-skills": {
+        "repo": "https://github.com/HeshamFS/materials-simulation-skills",
+        "commit": "fa1ce8d",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "coreyhaines31/makerskills": {
+        "repo": "https://github.com/coreyhaines31/makerskills",
+        "commit": "17218de",
+        "license": "MIT",
+        "skills": 1
+      },
+      "open-gitagent/opengap": {
+        "repo": "https://github.com/open-gitagent/opengap",
+        "commit": "d7a8e2e",
+        "license": "MIT",
+        "skills": 1
+      },
+      "JimLiu/baoyu-skills": {
+        "repo": "https://github.com/JimLiu/baoyu-skills",
+        "commit": "6b7a2e4",
+        "license": "MIT",
+        "skills": 1
+      },
+      "indranilbanerjee/digital-marketing-pro": {
+        "repo": "https://github.com/indranilbanerjee/digital-marketing-pro",
+        "commit": "a3d119c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "rampstackco/claude-skills": {
+        "repo": "https://github.com/rampstackco/claude-skills",
+        "commit": "bc6d961",
+        "license": "MIT",
+        "skills": 1
+      },
+      "zebbern/claude-code-guide": {
+        "repo": "https://github.com/zebbern/claude-code-guide",
+        "commit": "d2c5280",
+        "license": "MIT",
+        "skills": 2
+      },
+      "brycewang-stanford/Auto-Empirical-Research-Skills": {
+        "repo": "https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills",
+        "commit": "85bf545",
+        "license": "CC-BY-4.0",
+        "skills": 1
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 1
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 7,
+      "adjacent": 73
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 25,
+      "onet": 60,
+      "jobads": 90,
+      "wiki_ai": 0,
+      "anthropic": 5,
+      "ai_skills": 186,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 6.8,
+      "onet": 16.4,
+      "jobads": 24.6,
+      "wiki_ai": 0.0,
+      "anthropic": 1.4,
+      "ai_skills": 50.8,
+      "stackx": 0.0
+    },
+    "method": "content items per source category"
+  },
+  "collar": "white",
+  "computer_work": true
+}
--- a/references/ai-skills.md
+++ b/references/ai-skills.md
@@ -0,0 +1,394 @@
+# External AI agent skills — fitness-instructor
+
+Proven, publicly available AI agent skills mapped to this occupation.
+Nothing is copied from the sources: every entry is a name, a one-line
+summary and a link to the upstream skill package. Each section names
+its source repository, commit, license and retrieval date.
+
+**Tiers:** `core` = the skill directly exercises a top market hard
+skill, tool or method (from gated job-ad evidence) or an essential
+ESCO competence of this occupation; `adjacent` =
+plausibly useful, secondary. Entries are capped at 12 per source
+and 80 in total per occupation (core first,
+strongest matches survive); everything beyond the caps is excluded
+and logged in the pipeline audit trail, not in this package.
+
+_Matched deterministically (ISCO group + title/competence keywords,
+tiered against market evidence + ESCO essentials) by
+`pipeline/p5_enrich_ai_skills.py` on 2026-07-14._
+
+## Source: anthropics/skills
+
+- Repository: [https://github.com/anthropics/skills](https://github.com/anthropics/skills) (commit `f6656c1`, retrieved 2026-07-14)
+- License: Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available — see the LICENSE.txt in the upstream skill folder
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `docx` | adjacent | Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to … | [source](https://github.com/anthropics/skills/tree/main/skills/docx) |
+| `pdf` | adjacent | Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating … | [source](https://github.com/anthropics/skills/tree/main/skills/pdf) |
+
+## Source: a5c-ai/babysitter
+
+- Repository: [https://github.com/a5c-ai/babysitter](https://github.com/a5c-ai/babysitter) (commit `44a5d58b`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `training-curriculum-designer` | core | Design training curricula and learning paths for change initiatives with competency-based learning | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/business/business-analysis/skills/training-curriculum-designer) |
+| `lessonly-training` | adjacent | Lessonly (Seismic Learning) training platform integration | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/business/sales/skills/lessonly-training) |
+| `lms-admin` | adjacent | Configure and manage Learning Management System operations including courses, enrollments, compliance training, and learning analytics | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/business/human-resources/skills/lms-admin) |
+
+## Source: affaan-m/everything-claude-code
+
+- Repository: [https://github.com/affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) (commit `ed38744`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `documentation-lookup` | adjacent | Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma). | [source](https://github.com/affaan-m/everything-claude-code/tree/ed38744/.agents/skills/documentation-lookup) |
+
+## Source: alirezarezvani/claude-skills
+
+- Repository: [https://github.com/alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) (commit `0241f43`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `compliance-readiness` | adjacent | /cs:compliance-readiness <program> — Multi-framework compliance officer 6-question forcing interrogation of any compliance program. Use before starting a new framework, planning the annual audit calendar, or preparing for certification … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/compliance-os/skills/compliance-readiness) |
+
+## Source: AlpacaLabsLLC/skills-for-architects
+
+- Repository: [https://github.com/AlpacaLabsLLC/skills-for-architects](https://github.com/AlpacaLabsLLC/skills-for-architects) (commit `4476576`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `learn` | adjacent | Guided, hands-on course teaching architects how to use Claude Code — six short modules, each built around an exercise on a bundled sandbox project (a fictional Brooklyn art museum expansion). Resumable across sessions via PROGRESS.md. Use … | [source](https://github.com/AlpacaLabsLLC/skills-for-architects/tree/4476576/skills/learn) |
+| `meeting-minutes` | adjacent | Turn a meeting transcript, notes, or conversation into collision-safe, source-linked minutes in meetings/YYYY-MM-DD-slug.md. Use for project meeting records, attendance, discussion, stated information, decisions, action candidates, and … | [source](https://github.com/AlpacaLabsLLC/skills-for-architects/tree/4476576/skills/meeting-minutes) |
+
+## Source: basicmachines-co/basic-memory
+
+- Repository: [https://github.com/basicmachines-co/basic-memory](https://github.com/basicmachines-co/basic-memory) (commit `53da71c`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `memory-onboarding` | adjacent | Guide someone new to Basic Memory through designing and building a complete personal knowledge system — interview them about what they want to track, propose a structure, build it with schemas and instruction notes, teach them to use it, … | [source](https://github.com/basicmachines-co/basic-memory/tree/53da71c/skills/memory-onboarding) |
+| `bm-share` | adjacent | Promote a note from your personal Basic Memory project to a shared team project, with attribution. Use when the user says "share this with the team", "publish this decision", or runs /basic-memory:bm-share. This is the deliberate way to … | [source](https://github.com/basicmachines-co/basic-memory/tree/53da71c/plugins/claude-code/skills/bm-share) |
+
+## Source: brycewang-stanford/Auto-Empirical-Research-Skills
+
+- Repository: [https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills) (commit `85bf545`, retrieved 2026-07-14)
+- License: CC-BY-4.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `education-skills` | adjacent | 7 education research skills. Trigger: pedagogical research, course design, learning analytics, assessment. Design: evidence-based teaching methods and educational measurement tools. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/education) |
+
+## Source: coreyhaines31/makerskills
+
+- Repository: [https://github.com/coreyhaines31/makerskills](https://github.com/coreyhaines31/makerskills) (commit `17218de`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `toolify` | adjacent | When you want to integrate an external tool, API, MCP server, or service into a project — the wizard walks you through auth, config, env vars, client wrapper code, example usage, and (optionally) a smoke-test. Scoped to Next.js and Rails … | [source](https://github.com/coreyhaines31/makerskills/tree/17218de/skills/toolify) |
+
+## Source: davila7/claude-code-templates
+
+- Repository: [https://github.com/davila7/claude-code-templates](https://github.com/davila7/claude-code-templates) (commit `fa79251`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `quantizing-models-bitsandbytes` | adjacent | Quantizes LLMs to 8-bit or 4-bit for 50-75% memory reduction with minimal accuracy loss. Use when GPU memory is limited, need to fit larger models, or want faster inference. Supports INT8, NF4, FP4 formats, QLoRA training, and 8-bit … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/optimization-bitsandbytes) |
+| `gptq` | adjacent | Post-training 4-bit quantization for LLMs with minimal accuracy loss. Use for deploying large models (70B, 405B) on consumer GPUs, when you need 4× memory reduction with <2% perplexity degradation, or for faster inference (3-4× speedup) vs … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/optimization-gptq) |
+| `optimizing-attention-flash` | adjacent | Optimizes transformer attention with Flash Attention for 2-4x speedup and 10-20x memory reduction. Use when training/running transformers with long sequences (>512 tokens), encountering GPU memory issues with attention, or need faster … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/optimization-flash-attention) |
+| `unsloth` | adjacent | Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/fine-tuning-unsloth) |
+| `it-operations` | adjacent | Manages IT infrastructure, monitoring, incident response, and service reliability. Provides frameworks for ITIL service management, observability strategies, automation, backup/recovery, capacity planning, and operational excellence … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/development/it-operations) |
+| `get-available-resources` | adjacent | This skill should be used at the start of any computationally intensive scientific task to detect and report available system resources (CPU cores, GPUs, memory, disk space). It creates a JSON file with resource information and strategic … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/get-available-resources) |
+
+## Source: Devin-AXIS/iPolloWork
+
+- Repository: [https://github.com/Devin-AXIS/iPolloWork](https://github.com/Devin-AXIS/iPolloWork) (commit `5107542`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `wechat-official-messages` | core | Design safe WeChat follower-message automation and send customer-service text only when the user provides an explicit target and confirmation. | [source](https://github.com/Devin-AXIS/iPolloWork/tree/5107542/examples/plugin-packages/wechat-official/.opencode/skills/wechat-official-messages) |
+| `stripe-safe-operations` | adjacent | Review and execute explicitly requested Stripe writes with exact environment, object, amount, currency, customer, and irreversible-effect confirmation. | [source](https://github.com/Devin-AXIS/iPolloWork/tree/5107542/examples/plugin-packages/stripe/.opencode/skills/stripe-safe-operations) |
+| `wechat-official-assets` | adjacent | Prepare selected workspace images and information cards as WeChat Official Account cover and article assets without reading outside the active workspace. | [source](https://github.com/Devin-AXIS/iPolloWork/tree/5107542/examples/plugin-packages/wechat-official/.opencode/skills/wechat-official-assets) |
+| `github` | adjacent | Use the connected iPolloWork GitHub service to inspect repositories, pull requests, issues, reviews, and Actions, then route focused work to the review, CI, or publish skill. | [source](https://github.com/Devin-AXIS/iPolloWork/tree/5107542/examples/plugin-packages/github/.opencode/skills/github) |
+
+## Source: foryourhealth111-pixel/Vibe-Skills
+
+- Repository: [https://github.com/foryourhealth111-pixel/Vibe-Skills](https://github.com/foryourhealth111-pixel/Vibe-Skills) (commit `34429a8`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `unsloth` | adjacent | Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/unsloth) |
+| `get-available-resources` | adjacent | This skill should be used at the start of any computationally intensive scientific task to detect and report available system resources (CPU cores, GPUs, memory, disk space). It creates a JSON file with resource information and strategic … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/get-available-resources) |
+
+## Source: gooseworks-ai/goose-skills
+
+- Repository: [https://github.com/gooseworks-ai/goose-skills](https://github.com/gooseworks-ai/goose-skills) (commit `94ec916`, retrieved 2026-07-14)
+- License: no explicit license — referenced by link only
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `youtube-watcher` | adjacent | Fetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it. | [source](https://github.com/gooseworks-ai/goose-skills/tree/94ec916/skills/research-tools/capabilities/youtube-watcher) |
+
+## Source: HeshamFS/materials-simulation-skills
+
+- Repository: [https://github.com/HeshamFS/materials-simulation-skills](https://github.com/HeshamFS/materials-simulation-skills) (commit `fa1ce8d`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `slurm-job-script-generator` | adjacent | Generate correct, copy-pasteable SLURM sbatch job scripts and sanity-check HPC resource requests — configure nodes, MPI tasks, OpenMP threads, memory (per-node or per-cpu), GPUs, walltime, partitions, modules, and environment variables, … | [source](https://github.com/HeshamFS/materials-simulation-skills/tree/fa1ce8d/skills/hpc-deployment/slurm-job-script-generator) |
+
+## Source: hoangsonww/Claude-Code-Agent-Monitor
+
+- Repository: [https://github.com/hoangsonww/Claude-Code-Agent-Monitor](https://github.com/hoangsonww/Claude-Code-Agent-Monitor) (commit `8f87ce1`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `sprint-summary` | adjacent | Summarize a sprint's worth of Claude Code activity — sessions grouped by project (cwd), per-model cost breakdown, token efficiency (cache hit rate, compaction baselines), subagent effectiveness from workflow API, velocity metrics … | [source](https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/8f87ce1/plugins/ccam-productivity/skills/sprint-summary) |
+
+## Source: indranilbanerjee/digital-marketing-pro
+
+- Repository: [https://github.com/indranilbanerjee/digital-marketing-pro](https://github.com/indranilbanerjee/digital-marketing-pro) (commit `a3d119c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `client-proposal` | adjacent | Draft agency proposals. Use when: pitch deck, scope of work, SLA, capabilities presentation for prospects or clients. | [source](https://github.com/indranilbanerjee/digital-marketing-pro/tree/a3d119c/skills/client-proposal) |
+
+## Source: JasonColapietro/suede-creator-skills
+
+- Repository: [https://github.com/JasonColapietro/suede-creator-skills](https://github.com/JasonColapietro/suede-creator-skills) (commit `0dc2aef`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `suede-offers` | adjacent | Suede-affiliated offer design for value framing, bonuses, guarantees, risk reversal, honest scarcity, naming, and payment structure. Use when the user is building or diagnosing a service, course, coaching, information-product, agency, or … | [source](https://github.com/JasonColapietro/suede-creator-skills/tree/0dc2aef/skills/suede-offers) |
+
+## Source: jeremylongshore/claude-code-plugins-plus-skills
+
+- Repository: [https://github.com/jeremylongshore/claude-code-plugins-plus-skills](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) (commit `e112938a`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `customerio-hello-world` | core | Create a minimal working Customer.io example. Use when learning Customer.io basics, testing SDK setup, or creating your first identify + track integration. Trigger: "customer.io hello world", "first customer.io message", "test … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/saas-packs/customerio-pack/skills/customerio-hello-world) |
+| `draft-landing` | adjacent | Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-agency/tonone/skills/draft-landing) |
+| `surge-activation` | adjacent | Use when asked to improve activation, map the growth funnel, identify growth levers, design a referral program, build a retention playbook, develop a PLG strategy, or find where to invest in growth. Examples: "how do we grow faster", … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-agency/tonone/bundle/revenue-team/skills/surge-activation) |
+| `clickhouse-rate-limits` | adjacent | Configure ClickHouse query concurrency, memory quotas, and connection limits. Use when hitting "too many simultaneous queries", managing concurrent users, or tuning server-side resource limits. Trigger: "clickhouse rate limit", "clickhouse … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/saas-packs/clickhouse-pack/skills/clickhouse-rate-limits) |
+| `gcp-examples-expert` | adjacent | Generate production-ready Google Cloud code examples from official repositories including ADK samples, Genkit templates, Vertex AI notebooks, and Gemini patterns. Use when asked to "show ADK example" or "provide GCP starter kit". Trigger … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-ml/jeremy-gcp-starter-examples/skills/gcp-examples-expert) |
+
+## Source: JimLiu/baoyu-skills
+
+- Repository: [https://github.com/JimLiu/baoyu-skills](https://github.com/JimLiu/baoyu-skills) (commit `6b7a2e4`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `baoyu-wechat-summary` | adjacent | Summarizes WeChat group chat highlights into a structured digest using the local wx-cli binary (https://github.com/jackwener/wx-cli). Generates a normal digest by default; a roast (毒舌) version is opt-in. Maintains per-group history … | [source](https://github.com/JimLiu/baoyu-skills/tree/6b7a2e4/skills/baoyu-wechat-summary) |
+
+## Source: K-Dense-AI/claude-scientific-skills
+
+- Repository: [https://github.com/K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `get-available-resources` | adjacent | This skill should be used at the start of any computationally intensive scientific task to detect and report available system resources (CPU cores, GPUs, memory, disk space). It creates a JSON file with resource information and strategic … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/get-available-resources) |
+
+## Source: K-Dense-AI/scientific-agent-skills
+
+- Repository: [https://github.com/K-Dense-AI/scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `get-available-resources` | adjacent | This skill should be used at the start of any computationally intensive scientific task to detect and report available system resources (CPU cores, GPUs, memory, disk space). It creates a JSON file with resource information and strategic … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/get-available-resources) |
+
+## Source: ljagiello/ctf-skills
+
+- Repository: [https://github.com/ljagiello/ctf-skills](https://github.com/ljagiello/ctf-skills) (commit `d19f35f`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ctf-ai-ml` | adjacent | Provides AI and machine learning techniques for CTF challenges. Use when attacking ML models, crafting adversarial examples, performing model extraction, prompt injection, membership inference, training data poisoning, fine-tuning … | [source](https://github.com/ljagiello/ctf-skills/tree/d19f35f/ctf-ai-ml) |
+
+## Source: mattpocock/skills
+
+- Repository: [https://github.com/mattpocock/skills](https://github.com/mattpocock/skills) (commit `66898f6`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `scaffold-exercises` | adjacent | Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section. | [source](https://github.com/mattpocock/skills/tree/66898f6/skills/misc/scaffold-exercises) |
+
+## Source: mcollina/skills
+
+- Repository: [https://github.com/mcollina/skills](https://github.com/mcollina/skills) (commit `5b2a813`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `skill-optimizer` | adjacent | Optimizes AI skills for activation, clarity, and cross-model reliability. Use when creating or editing skill packs, diagnosing weak skill uptake, reducing regressions, tuning instruction salience, improving examples, shrinking context … | [source](https://github.com/mcollina/skills/tree/5b2a813/skills/skill-optimizer) |
+
+## Source: mohitagw15856/pm-claude-skills
+
+- Repository: [https://github.com/mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) (commit `876fa30`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `kyc-escalation` | adjacent | Write an internal KYC/AML escalation memo: a factual time-stamped trigger description, customer-profile vs activity mismatch analysis, red-flag taxonomy mapping, outstanding information, and a recommendation with rationale. Use when asked … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-banking/skills/kyc-escalation) |
+| `teaching-lesson-plan` | adjacent | Design a structured lesson plan for any subject, audience, or format. Use when asked to write a lesson plan, course outline, teaching session, workshop curriculum, or training module. Produces a complete lesson plan with learning … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-cross/skills/teaching-lesson-plan) |
+| `lifecycle-crm-plan` | adjacent | Design lifecycle marketing / CRM journeys across the customer lifecycle. Use when asked to plan onboarding emails, lifecycle/CRM campaigns, drip sequences, re-engagement or winback flows, or a messaging calendar. Produces a lifecycle plan … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-growth/skills/lifecycle-crm-plan) |
+| `lesson-plan` | adjacent | Build a complete, standards-aligned lesson plan with clear objectives, a timed activity sequence, differentiation, and assessment. Use when asked to write a lesson plan, plan a class or lesson, design a teaching session, or structure … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-education/skills/lesson-plan) |
+
+## Source: muratcankoylan/Agent-Skills-for-Context-Engineering
+
+- Repository: [https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) (commit `c578e85`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `book-sft-pipeline` | core | This skill should be used for book-to-SFT pipelines: ePub extraction, literary segmentation, author-voice dataset construction, style-transfer training, LoRA workflows, and model evaluation for voice replication. | [source](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/c578e85/examples/book-sft-pipeline) |
+| `reasoning-trace-optimizer` | adjacent | Debug and optimize AI agents by analyzing reasoning traces, context degradation, tool confusion, instruction drift, repeated task failures, and performance regressions. | [source](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering/tree/c578e85/examples/interleaved-thinking) |
+
+## Source: mxyhi/ok-skills
+
+- Repository: [https://github.com/mxyhi/ok-skills](https://github.com/mxyhi/ok-skills) (commit `94707b6`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `find-docs` | adjacent | Retrieves up-to-date documentation, API references, and code examples for any developer technology. Use this skill whenever the user asks about a specific library, framework, SDK, CLI tool, or cloud service — even for well-known ones like … | [source](https://github.com/mxyhi/ok-skills/tree/94707b6/find-docs) |
+
+## Source: nexscope-ai/eCommerce-Skills
+
+- Repository: [https://github.com/nexscope-ai/eCommerce-Skills](https://github.com/nexscope-ai/eCommerce-Skills) (commit `56f3288`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ecommerce-content-marketing` | adjacent | E-commerce content marketing strategy planner. Generates content calendars, topic ideas, and platform-specific strategies by analyzing customer reviews, trends, competitor content, and SEO opportunities. Two modes: (A) Build — create a … | [source](https://github.com/nexscope-ai/eCommerce-Skills/tree/56f3288/ecommerce-content-marketing) |
+| `ecommerce-social-media-marketing` | adjacent | Social media marketing strategy for ecommerce brands. Content calendar planning, platform-specific strategies, social commerce optimization, influencer collaboration, and community building. Use when the user asks about social media … | [source](https://github.com/nexscope-ai/eCommerce-Skills/tree/56f3288/ecommerce-social-media-marketing) |
+
+## Source: nexu-io/open-design
+
+- Repository: [https://github.com/nexu-io/open-design](https://github.com/nexu-io/open-design) (commit `4b66023`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `marketing-psychology` | core | Apply psychological principles and behavioral science to copy and design. Useful for tightening hooks, framing, and pricing presentation. | [source](https://github.com/nexu-io/open-design/tree/4b66023/skills/marketing-psychology) |
+| `html-ppt-zhangzara-daisy-days` | adjacent | A customer-success workshop onboarding users to a project-management app — the first-value path and the habits that retain. Built as a decision-grade professional training deck for new customers, CS team. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/html-ppt-zhangzara-daisy-days) |
+| `hps-bauhaus` | adjacent | A visual-design fundamentals course for new brand designers — grid, type, color, and the exercises that build the eye. Built as a decision-grade professional training deck for junior designers, new hires. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/hps-bauhaus) |
+| `html-ppt-course-module` | adjacent | A first-30-days onboarding module for new hospitality hires — the behaviors, the practice, the checks, and the manager follow-up. Built as a decision-grade professional training deck for new hires, managers. | [source](https://github.com/nexu-io/open-design/tree/4b66023/design-templates/html-ppt-course-module) |
+| `html-ppt-zhangzara-cobalt-grid` | adjacent | Open Design renewal + seat-expansion business case for a growing customer: realized value, usage proof, and the expansion ROI. Built as a decision-grade B2B sales deck for champion, finance approver. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/html-ppt-zhangzara-cobalt-grid) |
+| `html-ppt-zhangzara-playful` | adjacent | A retail sales-floor training on consultative selling — the flow, the role-plays, and the daily habit that lifts conversion. Built as a decision-grade professional training deck for store associates, floor managers. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/html-ppt-zhangzara-playful) |
+| `html-ppt-zhangzara-retro-windows` | adjacent | An IT security-awareness training on spotting phishing — the tells, the drill, and what to do in the first 60 seconds. Built as a decision-grade professional training deck for all employees. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/html-ppt-zhangzara-retro-windows) |
+| `html-ppt-zhangzara-studio` | adjacent | A photography studio's portfolio-and-rate deck — the signature work, the process, and the packages that win the brief. Built as a decision-grade design craft deck for prospective clients. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/html-ppt-zhangzara-studio) |
+| `pptx` | adjacent | Read, generate, and adjust PowerPoint slides, layouts, and templates. Useful for executive decks, training material, and product reviews. | [source](https://github.com/nexu-io/open-design/tree/4b66023/skills/pptx) |
+| `create-live-artifact-ops` | adjacent | Create a refreshable live operations artifact for customer success, support, or launch review workflows. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/spec/examples/create-live-artifact-ops) |
+| `kami-deck` | adjacent | A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Built as a decision-grade academic research deck for lab group, PI. | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/kami-deck) |
+| `dating-web` | adjacent | A consumer-feeling dating / matchmaking dashboard — left rail navigation, ticker bar of community signals, headline KPIs, a 30-day mutual-matches bar chart, and a match-rate trend block. Editorial typography, restrained accent. Use when … | [source](https://github.com/nexu-io/open-design/tree/4b66023/plugins/_official/examples/dating-web) |
+
+## Source: open-gitagent/opengap
+
+- Repository: [https://github.com/open-gitagent/opengap](https://github.com/open-gitagent/opengap) (commit `d7a8e2e`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `wiki-ingest` | adjacent | Ingest a raw source document into the wiki. Reads the source, extracts key information, creates or updates wiki pages, maintains cross-references, and logs the operation. Use when the user adds a new source or says 'ingest this'. | [source](https://github.com/open-gitagent/opengap/tree/d7a8e2e/examples/llm-wiki/skills/wiki-ingest) |
+
+## Source: OpenRaiser/NanoResearch
+
+- Repository: [https://github.com/OpenRaiser/NanoResearch](https://github.com/OpenRaiser/NanoResearch) (commit `7144364`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `unsloth` | adjacent | Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization | [source](https://github.com/OpenRaiser/NanoResearch/tree/7144364/skills/vendor-ai-research/unsloth) |
+
+## Source: Orchestra-Research/AI-research-SKILLs
+
+- Repository: [https://github.com/Orchestra-Research/AI-research-SKILLs](https://github.com/Orchestra-Research/AI-research-SKILLs) (commit `773a529`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `pytorch-fsdp2` | core | Adds PyTorch FSDP2 (fully_shard) to training scripts with correct init, sharding, mixed precision/offload config, and distributed checkpointing. Use when models exceed single-GPU memory or when you need DTensor-based sharding with … | [source](https://github.com/Orchestra-Research/AI-research-SKILLs/tree/773a529/08-distributed-training/pytorch-fsdp2) |
+| `quantizing-models-bitsandbytes` | adjacent | Quantizes LLMs to 8-bit or 4-bit for 50-75% memory reduction with minimal accuracy loss. Use when GPU memory is limited, need to fit larger models, or want faster inference. Supports INT8, NF4, FP4 formats, QLoRA training, and 8-bit … | [source](https://github.com/Orchestra-Research/AI-research-SKILLs/tree/773a529/10-optimization/bitsandbytes) |
+| `gptq` | adjacent | Post-training 4-bit quantization for LLMs with minimal accuracy loss. Use for deploying large models (70B, 405B) on consumer GPUs, when you need 4× memory reduction with <2% perplexity degradation, or for faster inference (3-4× speedup) vs … | [source](https://github.com/Orchestra-Research/AI-research-SKILLs/tree/773a529/10-optimization/gptq) |
+| `optimizing-attention-flash` | adjacent | Optimizes transformer attention with Flash Attention for 2-4x speedup and 10-20x memory reduction. Use when training/running transformers with long sequences (>512 tokens), encountering GPU memory issues with attention, or need faster … | [source](https://github.com/Orchestra-Research/AI-research-SKILLs/tree/773a529/10-optimization/flash-attention) |
+| `unsloth` | adjacent | Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization | [source](https://github.com/Orchestra-Research/AI-research-SKILLs/tree/773a529/03-fine-tuning/unsloth) |
+
+## Source: pedrohcgs/claude-code-my-workflow
+
+- Repository: [https://github.com/pedrohcgs/claude-code-my-workflow](https://github.com/pedrohcgs/claude-code-my-workflow) (commit `be53c12`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `promote-memory` | adjacent | Review candidate `[LEARN]` entries in `.claude/state/personal-memory.md` (gitignored) and run them through a five-critic council in parallel: generality, staleness, redundancy, evidence, format. Majority vote (3+ of 5) promotes the entry … | [source](https://github.com/pedrohcgs/claude-code-my-workflow/tree/be53c12/.claude/skills/promote-memory) |
+
+## Source: rampstackco/claude-skills
+
+- Repository: [https://github.com/rampstackco/claude-skills](https://github.com/rampstackco/claude-skills) (commit `bc6d961`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `content-strategy` | adjacent | Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning. Use this skill whenever the user wants to plan a content program, define content pillars, build an … | [source](https://github.com/rampstackco/claude-skills/tree/bc6d961/skills/content-strategy) |
+
+## Source: ruvnet/claude-code-flow
+
+- Repository: [https://github.com/ruvnet/claude-code-flow](https://github.com/ruvnet/claude-code-flow) (commit `73914bd`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `Hooks Automation` | adjacent | Automated coordination, formatting, and learning from Claude Code operations using intelligent hooks with MCP integration. Includes pre$post task hooks, session management, Git integration, memory coordination, and neural pattern training … | [source](https://github.com/ruvnet/claude-code-flow/tree/73914bd/.agents/skills/hooks-automation) |
+
+## Source: ruvnet/ruflo
+
+- Repository: [https://github.com/ruvnet/ruflo](https://github.com/ruvnet/ruflo) (commit `73914bd`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `Hooks Automation` | adjacent | Automated coordination, formatting, and learning from Claude Code operations using intelligent hooks with MCP integration. Includes pre$post task hooks, session management, Git integration, memory coordination, and neural pattern training … | [source](https://github.com/ruvnet/ruflo/tree/73914bd/.agents/skills/hooks-automation) |
+
+## Source: zebbern/claude-code-guide
+
+- Repository: [https://github.com/zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide) (commit `d2c5280`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `cross-examine` | adjacent | Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me". | [source](https://github.com/zebbern/claude-code-guide/tree/d2c5280/skills/cross-examine) |
+| `dev-guide-generator` | adjacent | Generates complete technical tutorials from prerequisites and environment setup to core steps, troubleshooting, and a final cheatsheet. Trigger on requests to write a tutorial, create a setup guide, organize steps for beginners, or … | [source](https://github.com/zebbern/claude-code-guide/tree/d2c5280/skills/dev-guide-generator) |
+
+## Source: zechenzhangAGI/AI-research-SKILLs
+
+- Repository: [https://github.com/zechenzhangAGI/AI-research-SKILLs](https://github.com/zechenzhangAGI/AI-research-SKILLs) (commit `773a529`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `pytorch-fsdp2` | core | Adds PyTorch FSDP2 (fully_shard) to training scripts with correct init, sharding, mixed precision/offload config, and distributed checkpointing. Use when models exceed single-GPU memory or when you need DTensor-based sharding with … | [source](https://github.com/zechenzhangAGI/AI-research-SKILLs/tree/773a529/08-distributed-training/pytorch-fsdp2) |
+| `quantizing-models-bitsandbytes` | adjacent | Quantizes LLMs to 8-bit or 4-bit for 50-75% memory reduction with minimal accuracy loss. Use when GPU memory is limited, need to fit larger models, or want faster inference. Supports INT8, NF4, FP4 formats, QLoRA training, and 8-bit … | [source](https://github.com/zechenzhangAGI/AI-research-SKILLs/tree/773a529/10-optimization/bitsandbytes) |
+| `gptq` | adjacent | Post-training 4-bit quantization for LLMs with minimal accuracy loss. Use for deploying large models (70B, 405B) on consumer GPUs, when you need 4× memory reduction with <2% perplexity degradation, or for faster inference (3-4× speedup) vs … | [source](https://github.com/zechenzhangAGI/AI-research-SKILLs/tree/773a529/10-optimization/gptq) |
+| `optimizing-attention-flash` | adjacent | Optimizes transformer attention with Flash Attention for 2-4x speedup and 10-20x memory reduction. Use when training/running transformers with long sequences (>512 tokens), encountering GPU memory issues with attention, or need faster … | [source](https://github.com/zechenzhangAGI/AI-research-SKILLs/tree/773a529/10-optimization/flash-attention) |
+| `unsloth` | adjacent | Expert guidance for fast fine-tuning with Unsloth - 2-5x faster training, 50-80% less memory, LoRA/QLoRA optimization | [source](https://github.com/zechenzhangAGI/AI-research-SKILLs/tree/773a529/03-fine-tuning/unsloth) |
--- a/references/berufsbild-de.md
+++ b/references/berufsbild-de.md
@@ -0,0 +1,108 @@
+# Berufsbild (Deutschland) — Fitnesstrainer/in
+
+> **Quelle:** BERUFENET, Bundesagentur für Arbeit — Beruf-ID 15658,
+> KldB 2010: B 84553 · via öffentliche BERUFENET-API,
+> abgerufen 2026-07-12. Automatisches Label-Matching
+> (Score 1.00); Inhalte paraphrasiert/gekürzt, Volltext beim
+> Original: https://web.arbeitsagentur.de/berufenet/beruf/15658
+
+## Steckbrief
+
+Berufstyp
+Aus- bzw. Weiterbildungsberuf
+Ausbildungsart
+Schulische Aus- bzw. Weiterbildung an unterschiedlichen Bildungseinrichtungen (intern geregelt)
+Ausbildungsdauer
+Unterschiedlich, je nach Bildungsangebot, Unterrichtszeit (Vollzeit/Teilzeit) und Lernform
+Lernorte
+Bildungseinrichtung und Praktikumsbetrieb
+Was macht man in diesem Beruf?Fitnesstrainer/innen leiten Einzelpersonen und Gruppen in Sport- und Fitnessstudios an, unterstützen und korrigieren sie beim Sport. Insbesondere unterweisen sie Sporttreibende im richtigen Umgang mit Fitnessgeräten. Sie motivieren die Teilnehmer/innen, überprüfen Übungen auf ihre Effektivität und machen Fitnesstests. Darüber hinaus führen sie Trainingseinheiten wie Aerobic, Pilates oder Wirbelsäulengymnastik durch und bieten Fitnesskurse sowie Walking- oder Lauftreffs an. Sie erarbeiten Fitnesspläne, beraten bezüglich Trainingsaufbau und -gestaltung sowie in Ernährungsfragen und bieten z.B. auch Kurse zu Entspannungstechniken an.
+Wo arbeitet man?Beschäftigungsbetriebe:Fitnesstrainer/innen finden Beschäftigung
+in Fitnessstudios und -zentren
+
+in Sportvereinen
+
+in Hotels, Ferienzentren und -clubs
+
+in Rehabilitationskliniken
+
+Arbeitsorte:Fitnesstraine
+
+## Die Ausbildung im Überblick
+
+Fitnesstrainer/in ist eine Aus- bzw. Weiterbildung, die durch interne Vorschriften der Lehrgangsträger geregelt ist. 
+Je nach Lehrgangsträger können z.B. Zugangsvoraussetzungen, Dauer der Aus- bzw. Weiterbildung und Abschlussbezeichnungen unterschiedlich sein.
+
+## Abschluss-/Berufsbezeichnungen
+
+Abschlussbezeichnungen (je nach Bildungsanbieter) z.B.Fitness-Instructor
+
+Fitnesstrainer/Fitnesstrainerin
+
+Fitness- und Gesundheitstrainer/Fitness- und Gesundheitstrainerin
+
+Fitness- und Wellness-Coach
+
+Fitness- und Wellness-Trainer/Fitness- und Wellness-Trainerin
+
+Sport- und Fitnesstrainer/Sport- und Fitnesstrainerin
+
+## Ausbildung im Ausland
+
+Für eine Aus- bzw. Weiterbildung im Ausland gibt es z.B. folgende Möglichkeiten:
+Österreich
+Aus- bzw. Weiterbildungsangebote: AMS Ausbildungskompass
+(z.B. mit dem Suchbegriff "Fitness")
+
+Aus- bzw. Weiterbildungsangebote: WIFI Österreich
+(z.B. mit dem Suchbegriff "Fitnesstrainer")
+
+Dokumentation beruflicher AuslandserfahrungenDer Europass bietet die Möglichkeit, im Ausland absolvierte Ausbildungsabschnitte und Lernaufenthalte zu dokumentieren.
+Weitere Informationen zum Europass
+
+## Ausbildungsdauer
+
+Unterschiedlich, je nach Bildungsangebot, Unterrichtszeit (Vollzeit/Teilzeit) und Lernform
+
+## Ausbildungsinhalte
+
+Während der Aus- bzw. Weiterbildung erwirbt man beispielsweise folgende Kenntnisse:Lehre von Aufbau und Struktur des menschlichen beziehungsweise tierischen Körpers
+" name="Anatomie">Anatomie und Lehre von den normalen (nicht krankhaften) Lebensvorgängen und Funktionen von Lebewesen und Organismen
+" name="Physiologie">Physiologie des passiven und aktiven Bewegungssystems
+
+Aufbau und Funktion der Muskel-Gelenk-Systeme
+
+Anatomie und Physiologie des Herz-Kreislauf-Systems
+
+allgemeine Trainingslehre
+
+Trainingsbelastungsparameter
+
+Aufbau einer Trainingseinheit
+
+Motorische Fähigkeiten (Ausdauer, Kraft, Schnelligkeit, Beweglichkeit, Koordination)
+
+Kraft-, Ausdauer- und Beweglichkeitstraining
+
+Gerätehandling und korrekte Übungsausführung
+
+funktionelles Training
+
+Erstellung von Trainingsplänen
+
+PraktikumIst ein Praktikum in die Aus- bzw. Weiterbildung integriert oder schließt sich eine Praxisphase an die Aus- bzw. Weiterbildung an, arbeiten die angehenden Fitnesstrainer/innen z.B. in Fitness-Studios oder in Unternehmen der Sport- und Freizeitindustrie mit.
+
+## Lernorte
+
+Fitnesstrainer/innen werden in schulischer Form ausgebildet.
+Lernorte sind
+bei Präsenzveranstaltungen: Unterrichtsräume an der Bildungseinrichtung
+
+bei Lernformen, bei denen die Wissensvermittlung ausschließlich über digitale Medien, z.B. elektronische Lernplattformen und -systeme, erfolgt; dazu gehören beispielsweise Online-Seminare oder Echtzeit-Unterricht im virtuellen Klassenzimmern
+" name="Digitale Lernformen">digitalen Lernformen (z.B. virtuelles Klassenzimmer) und Entgeltlicher Unterricht, der auf vertraglicher Grundlage erfolgt, bei dem der Lehrende und der Lernende ausschließlich oder überwiegend räumlich getrennt sind und der Lehrende den Lernerfolg überwacht; durch das Fernunterrichtsschutzgesetz (FernUSG) gesetzlich definiert; Bildungsangebote, die dieser Definition entsprechen unterliegen der Zulassungspflicht durch die Staatliche Zentralstelle für Fernunterricht (ZFU), einer Behörde der Länder
+" name="Fernunterricht">Fernunterricht: zu Hause, ggf. Unterrichtsräume bei Präsenzphasen
+
+bei Lernformen, bei denen die Vorteile von klassischem Präsenzunterricht und digitaler Lehre miteinander kombiniert werden; dazu gehört beispielsweise das sog. Blended Learning deutsch: "vermischtes Lernen"), das sich aus Präsenzphasen und medienbasierten Selbstlernphasen zusammensetzt
+" name="Kombinierte Lernformen">kombinierten Lernformen (z.B. Blended Learning): Unterrichtsräume bei Präsenzveranstaltungen, zu Hause bei Online-Lerneinheiten
+
+im Praktikum: Fitnessstudios oder Unternehmen der Sport- und Freizeitindustrie
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,140 @@
+# Market evidence report — fitness-instructor
+
+Source: **60 real job ads** (JSearch API, countries: us 60), extracted into the MSSQL evidence store; as of 2026-07-11.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| n/a | 29 | 48 % |
+| mid | 28 | 47 % |
+| senior | 1 | 2 % |
+| junior | 1 | 2 % |
+| lead | 1 | 2 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | group fitness instruction | 18 | 30 % |
+| 2 | swim instruction | 14 | 23 % |
+| 3 | customer service | 12 | 20 % |
+| 4 | fitness instruction | 10 | 17 % |
+| 5 | water safety | 7 | 12 % |
+| 6 | member motivation | 6 | 10 % |
+| 7 | equipment maintenance | 5 | 8 % |
+| 8 | group exercise instruction | 5 | 8 % |
+| 9 | exercise demonstration | 4 | 7 % |
+| 10 | lesson planning | 4 | 7 % |
+| 11 | safe exercise technique | 4 | 7 % |
+| 12 | swimming instruction | 4 | 7 % |
+| 13 | athletic conditioning | 3 | 5 % |
+| 14 | choreography planning | 3 | 5 % |
+| 15 | exercise instruction | 3 | 5 % |
+| 16 | exercise modification | 3 | 5 % |
+| 17 | fitness assessment | 3 | 5 % |
+| 18 | mobility training | 3 | 5 % |
+| 19 | reformer pilates | 3 | 5 % |
+| 20 | sprint coaching | 3 | 5 % |
+| 21 | strength training | 3 | 5 % |
+| 22 | water safety training | 3 | 5 % |
+| 23 | workout leadership | 3 | 5 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | heart-rate focused training | 4 | 7 % |
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | class preparation | 6 | 10 % |
+| 2 | program promotion | 6 | 10 % |
+| 3 | class delivery | 5 | 8 % |
+| 4 | client communication | 5 | 8 % |
+| 5 | member motivation | 5 | 8 % |
+| 6 | private swim lessons | 5 | 8 % |
+| 7 | providing feedback | 4 | 7 % |
+| 8 | small group swim lessons | 4 | 7 % |
+| 9 | workout delivery | 4 | 7 % |
+| 10 | coaching cues | 3 | 5 % |
+| 11 | equipment demonstration | 3 | 5 % |
+| 12 | equipment setup | 3 | 5 % |
+| 13 | leading lessons | 3 | 5 % |
+| 14 | leading workouts | 3 | 5 % |
+| 15 | member engagement | 3 | 5 % |
+| 16 | teaching classes | 3 | 5 % |
+| 17 | training space maintenance | 3 | 5 % |
+
+## Regional breakdown
+
+> **Corpus note:** 60 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+60 ads.
+
+**Top hard skills:**
+
+- group fitness instruction — 30 % (18 ads)
+- swim instruction — 23 % (14 ads)
+- customer service — 20 % (12 ads)
+- fitness instruction — 17 % (10 ads)
+- water safety — 12 % (7 ads)
+- member motivation — 10 % (6 ads)
+- equipment maintenance — 8 % (5 ads)
+- group exercise instruction — 8 % (5 ads)
+- exercise demonstration — 7 % (4 ads)
+- lesson planning — 7 % (4 ads)
+
+**Seniority:** n/a 48 % · mid 47 % · senior 2 % · junior 2 % · lead 2 %
+
+### UK (gb)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### EU/DACH (de, at, ch, nl)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+
+## Job title variants in the market
+
+| Title | Ads |
+|---|---|
+| Fitness Instructor | 7 |
+| Private Swim Instructor | 6 |
+| Group Fitness Instructor | 5 |
+| Swim Instructor | 3 |
+| Group Exercise Instructor | 2 |
+| Group Fitness Instructor - Intermediate | 2 |
+| In-Person Fitness Instructor - PRN | 2 |
+| Swim Instructor - Alexandria, VA | 2 |
+| AEROBICS - GROUP FITNESS INSTRUCTOR | 1 |
+| Aquatics Instructor | 1 |
+| Aquatics Swim Instructor | 1 |
+| Children's Fitness Instructor | 1 |
+| Cycle Instructor | 1 |
+| F45 Personal Trainer / Group Fitness Instructor | 1 |
+| Fitness Coach | 1 |
+| Fitness Coach CLEVELAND PARK | 1 |
+| Future Opening: Group Exercise Instructor/Les Mills Instructors | 1 |
+| Group Exercise Instructor - Substitute | 1 |
+| Group Fitness Instructor (3019) | 1 |
+| Group Fitness Instructor / Personal Trainer | 1 |
+| Group Fitness Instructor and Coach | 1 |
+| Group Fitness Instructor, Tysons Corner | 1 |
+| Group Fitness-Instructor | 1 |
+| Group Instructor and Coach | 1 |
+| Nation's Capital Swim Club is looking for swim instructors to conduct lessons in Washington, DC | 1 |
+
+Methodology: entities extracted per ad ({hard_skills, tools, methods, responsibilities, seniority}), normalized, counted as DISTINCT ads per entity; report threshold ≥ 3 ads. Headline sections in skills.md/tools.md use the stricter ≥ 20 % threshold.
--- a/references/profile.md
+++ b/references/profile.md
@@ -0,0 +1,31 @@
+# Occupation profile — fitness instructor
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/c784c2db-e636-429f-8492-3191790a58d7
+- **ESCO code:** 3423.2
+- **ISCO-08 group:** 3423 — Fitness and recreation instructors and program leaders
+
+## Description (ESCO)
+
+Fitness instructors build fitness participation of new and existing members through fitness experiences that meet their needs. They deliver fitness instruction to individuals, with the use of equipment, or to a group, through fitness classes. Both individual and group instructors have the purpose of promoting and delivering safe and effective exercise. Depending on the specific situation, some additional knowledge, skills and competences may be required.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- swimming instructor
+- fitness class instructor
+- aqua fitness instructor
+- indoor cycling trainer
+- fitness specialist
+- water aerobics instructor
+- gymnastics instructor
+- dance fitness instructor
+- aqua aerobics instructor
+- fitness group instructor
+- aerobics instructor
+- indoor cycling instructor
+- group fitness instructor
+- strength and conditioning coach
+- spinning instructor
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,47 @@
+# Competences — fitness instructor
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/c784c2db-e636-429f-8492-3191790a58d7).
+
+## Essential
+
+- **adapt fitness exercises** (skill/competence)
+- **analyse personal fitness information** (skill/competence)
+- **assess physical conditions of clients** (skill/competence)
+- **collect client fitness information** (skill/competence)
+- **correct fitness customers** (skill/competence)
+- **correct potentially harmful movements** (skill/competence)
+- **identify customer objectives** (skill/competence)
+- **integrate exercise science to the design of the programme** (skill/competence)
+- **maintain the exercise environment** (skill/competence)
+- **motivate fitness clients** (skill/competence)
+- **participate in training sessions** (skill/competence)
+- **promote fitness customer referral** (skill/competence)
+- **promote healthy fitness environment** (skill/competence)
+- **promote healthy lifestyle** (skill/competence)
+- **provide fitness customer care** (skill/competence)
+- **provide fitness customer service** (skill/competence)
+- **provide fitness information** (skill/competence)
+- **safely instruct about fitness** (skill/competence)
+
+## Optional
+
+- demonstrate when teaching (skill/competence)
+- ensure safety of exercise environment (skill/competence)
+- give constructive feedback (skill/competence)
+- human anatomy (knowledge)
+- integrate principles of training (skill/competence)
+- prescribe exercises (skill/competence)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 60 ads, as of 2026-07-11)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- group fitness instruction — **30 %**
+- swim instruction — **23 %**
+- customer service — **20 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,46 @@
+# Tasks & work activities — fitness instructor
+
+Source: O*NET 30.3, occupation 39-9031.00 (Exercise Trainers and Group Fitness Instructors) — manual nearest-occupation mapping via ISCO group 3423; the official ESCO crosswalk has no entry for this ESCO occupation.
+
+## Task statements
+
+- **[Core]** Explain and enforce safety rules and regulations governing sports, recreational activities, and the use of exercise equipment.
+- **[Core]** Offer alternatives during classes to accommodate different levels of fitness.
+- **[Core]** Plan routines, choose appropriate music, and choose different movements for each set of muscles, depending on participants' capabilities and limitations.
+- **[Core]** Observe participants and inform them of corrective measures necessary for skill improvement.
+- **[Core]** Teach proper breathing techniques used during physical exertion.
+- **[Core]** Instruct participants in maintaining exertion levels to maximize benefits from exercise routines.
+- **[Core]** Teach and demonstrate use of gymnastic and training equipment, such as trampolines and weights.
+- **[Core]** Maintain fitness equipment.
+- **[Supplemental]** Conduct therapeutic, recreational, or athletic activities.
+- **[Core]** Monitor participants' progress and adapt programs as needed.
+- **[Core]** Evaluate individuals' abilities, needs, and physical conditions, and develop suitable training programs to meet any special requirements.
+- **[Supplemental]** Plan physical education programs to promote development of participants' physical attributes and social skills.
+- **[Core]** Provide students with information and resources regarding nutrition, weight control, and lifestyle issues.
+- **[Core]** Administer emergency first aid, wrap injuries, treat minor chronic disabilities, or refer injured persons to physicians.
+- **[Core]** Advise clients about proper clothing and shoes.
+- **[Supplemental]** Teach individual and team sports to participants through instruction and demonstration, using knowledge of sports techniques and of participants' physical capabilities.
+- **[Supplemental]** Promote health clubs through membership sales, and record member information.
+- **[Core]** Maintain equipment inventories, and select, store, or issue equipment as needed.
+- **[Supplemental]** Organize and conduct competitions and tournaments.
+- **[Supplemental]** Advise participants in use of heat or ultraviolet treatments and hot baths.
+
+## Detailed work activities
+
+- Administer first aid.
+- Advise customers on the use of products or services.
+- Demonstrate activity techniques or equipment use.
+- Develop educational or training programs.
+- Distribute resources to patrons or employees.
+- Enforce rules or regulations.
+- Evaluate capabilities or training needs.
+- Explain regulations, policies, or procedures.
+- Maintain client information or service records.
+- Maintain supply or equipment inventories.
+- Organize recreational activities or events.
+- Perform basic equipment maintenance.
+- Promote products, services, or programs.
+- Provide medical or cosmetic advice for clients.
+- Sell products or services.
+- Teach exercise or fitness techniques.
+- Teach health or hygiene practices.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,28 @@
+# Tools & technology — fitness instructor
+
+Source: O*NET 30.3, occupation 39-9031.00 (Exercise Trainers and Group Fitness Instructors) — manual nearest-occupation mapping via ISCO group 3423; the official ESCO crosswalk has no entry for this ESCO occupation.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| Intuit QuickBooks | Accounting software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Word | Word processing software | yes |
+| Appointment scheduling software | Calendar and scheduling software |  |
+| BioEx Systems Exercise Expert | Data base user interface and query software |  |
+| BioEx Systems Fitness Maker | Project management software |  |
+| BioEx Systems Nutrition Maker Plus | Medical software |  |
+| Blink | Instant messaging software |  |
+| DaySmart Software Appointment-Plus | Calendar and scheduling software |  |
+| DietMaster Systems DietMaster | Data base user interface and query software |  |
+| Email software | Electronic mail software |  |
+| EZFacility Trainer Management System | Enterprise resource planning ERP software |  |
+| ICTraining | Data base user interface and query software |  |
+| MYOB BusinessEssentials | Accounting software |  |
+| Online River Software Personal Trainer Pro | Project management software |  |
+| Sage 50 Accounting | Accounting software |  |
+| Sage Simply Accounting | Accounting software |  |
+| Visual Health Information The Trainer's Exercise Toolbox | Desktop publishing software |  |
+| Web browser software | Internet browser software |  |