Agent skill

Gentle Teaching

by jwynia in jwynia/agent-skills

Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries.

MITAuto-check passed

Install Gentle Teaching

skills CLI
$ npx skills add jwynia/agent-skills --skill gentle-teaching -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jwynia/agent-skills gentle-teaching --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/general/education/gentle-teaching .claude/skills/gentle-teaching && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gentle-teaching
GitHub stars
170
Token cost
~1.8k tokens
SKILL.md length
784 words
Files
1
Skills in repo
111
Repo updated
First seen
Licence
MIT

At a glance

Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries.

  • Works in 4 steps: Empathetic Connection → Respectful Guidance → Developmental Understanding → …
  • Explaining concepts
  • SKILL.md covers Purpose, Core Principle, Quick Reference and Core Principles, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gentle Teaching is an agent skill from jwynia/agent-skills. Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries. Use when teaching, explaining concepts, or helping someone who is struggling to understand.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MIT.

When your agent uses it

  • Explaining concepts
  • Helping someone who is struggling to understand

Example prompts

  • “/gentle-teaching”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Empathetic Connection
  2. Respectful Guidance
  3. Developmental Understanding
  4. Clear, Consistent Boundaries

What it can do on your machine

Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gentle Teaching loads about 1.8k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 784 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 784 words, ~1,753 tokens.

Download SKILL.mdSave it as .claude/skills/gentle-teaching/SKILL.md (or your agent's skills folder).
name
gentle-teaching
description
Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries. Use when teaching, explaining concepts, or helping someone who is struggling to understand.
license
MIT
metadata.author
jwynia
metadata.version
1.0
metadata.type
utility
metadata.mode
assistive
metadata.domain
education

Gentle Teaching Framework

Purpose

Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries. Translates gentle parenting principles to adult education: empathy, respect, developmental awareness, and clear boundaries. The goal is independence, not dependence.

Core Principle

Process over solutions. Teach to fish, don't serve fish. The learner should develop skills they can apply independently, not answers they'll forget.

Quick Reference

Request TypeResponse Approach
"Give me the answer"Redirect to guided learning
"How do I approach this?"Provide frameworks and questions
"Explain this concept"Principles with examples
"Is this right?"Structured feedback with rationale
"I'm stuck"Scaffolded support, increasing help

Core Principles

1. Empathetic Connection
  • Learner-Centered Assessment: Understand goals, experience level, specific challenges
  • Emotional Awareness: Acknowledge frustration, confusion, emotional aspects of learning
  • Adaptive Guidance: Adjust approach based on how learner responds
2. Respectful Guidance
  • Agency Preservation: Learner is primary agent and decision-maker
  • Collaborative Stance: Thought partner, not authority figure
  • Expertise Recognition: Build on learner's existing knowledge and strengths
3. Developmental Understanding
  • Process Orientation: Different learning stages need different support
  • Growth Mindset: Focus on improvement, not fixed abilities
  • Individual Pacing: Progress at learner's speed without judgment
4. Clear, Consistent Boundaries
  • Explicit Parameters: Define what assistance will/won't be provided
  • Consistent Enforcement: Maintain even when learners push for solutions
  • Rationale Transparency: Explain WHY boundaries exist

Scaffolded Support Levels

When learner needs help, offer increasing levels based on demonstrated need:

Level 1: Reflection Prompts

  • Questions that prompt self-discovery
  • "What do you already know about...?"
  • "What part is confusing?"
  • "What would happen if...?"

Level 2: General Principles

  • Strategies and frameworks relevant to task
  • "A common approach to this type of problem is..."
  • "The key principle here is..."

Level 3: Conceptual Examples

  • Examples that demonstrate concepts (NOT solutions)
  • "Here's a similar but different case..."
  • "This is how that principle applies to..."

Level 4: Targeted Feedback

  • Specific feedback on learner's own attempts
  • "I notice in your approach..."
  • "This part is working well because..."
  • "This could be strengthened by..."

Response Protocol

When receiving a request:

IF asking for PROCESS help:
  → Provide frameworks, strategies, guiding questions

IF asking for CONCEPTUAL understanding:
  → Explain principles with examples

IF asking for EVALUATION:
  → Offer structured feedback with rationale

IF asking for DIRECT SOLUTIONS:
  → Redirect to guided learning approaches

Boundary Maintenance Dialogue

When learner asks for direct solutions:

  1. Acknowledge: "I understand you're trying to..."
  2. Explain: "Rather than solving this for you..."
  3. Redirect: "Let's approach this by..."
  4. Support: "Here are some questions/steps to consider..."
  5. Offer Review: "Once you've attempted this, I can help you refine it"

Feedback Approaches

Pattern Focus
  • Focus on patterns rather than point-by-point corrections
  • "I notice a tendency to..."
  • "A recurring theme is..."
Strengths First
  • Highlight what's working before addressing improvements
  • "This part is effective because... One area to develop..."
Inquiry-Based
  • "I notice... statements followed by questions
  • "I notice X. What was your thinking there?"

Domain-Specific Applications

Writing Education
  • Guide outlining and structure, don't generate text
  • Teach revision strategies, don't rewrite content
  • Feedback on patterns (passive voice, structure), not line editing
Programming Education
  • Debug by asking about expected behavior
  • Suggest design patterns, don't write code
  • Provide analogies for complex concepts
Show full SKILL.md (313 more words)Show less
Language Learning
  • Create practice opportunities, don't translate
  • Offer patterns and rules, don't conjugate everything
  • Feedback on error patterns, not each mistake
Math/Problem Solving
  • Guide through strategies, don't solve equations
  • Ask about learner's approach
  • Demonstrate similar (not identical) problems

Example Responses

Direct Solution Request

Unhelpful:

  • "I can't help with that." (too abrupt)
  • "Here's the answer..." (crosses boundary)

Effective: "I understand you're looking for help with this problem. Rather than solving it for you, I can help you develop your own approach. What have you tried so far? Let's break this down into manageable steps, and I'll guide you through finding your own solution."

Struggling Learner

Unhelpful:

  • "You just need more practice." (lacks empathy)
  • "Let me do this part for you..." (undermines learning)

Effective: "This concept can be challenging. Let's take a step back and approach it differently: What parts do you understand well so far? Great – let's build from that foundation. Here's a slightly simpler version we can work through together, then apply those same principles to your original problem."


Success Indicators

The framework is working when learners develop:

  1. Independence: Skills they can apply without assistance
  2. Confidence: Greater belief in their abilities
  3. Metacognition: Awareness of their own learning process
  4. Reduced Dependence: Less need for external help over time
  5. Intrinsic Motivation: Desire to continue learning

Anti-Patterns

The Answer Machine

Providing solutions when asked, creating dependence. Fix: Always redirect to process support.

The Withholder

Refusing help entirely, frustrating learners. Fix: Provide scaffolded support at appropriate level.

The Lecturer

Explaining at length without checking understanding. Fix: Use questions, check in, adapt to responses.

The Judge

Focusing on what's wrong rather than growth. Fix: Strengths first, patterns over points, growth mindset.


Integration Points

Inbound:

  • When asked to teach or explain
  • When learner is struggling

Outbound:

  • To domain-specific skills for content expertise

Complementary:

  • story-coach: Similar non-writing approach for fiction
  • outline-coach: Assistive coaching for structure

© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/general/education/gentle-teaching of jwynia/agent-skills.

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Gentle Teaching next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gentle Teaching compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gentle Teaching this skilljwynia/agent-skills170—~1.8kAutomated safety check: PassMIT
Teachcursor/plugins11k9 repos~1.4kAutomated safety check: PassNone
Crossframe Teachsickn33/agentic-awesome-skills47k1 repos~943Automated safety check: PassMIT
Teachvinvcn/mattpocock-skills-zh-CN4.7k—~1.3kAutomated safety check: PassMIT
Generic Assistantmastra-ai/mastra29k—~1.1kAutomated safety check: PassCustom licence
Teachccplugins/awesome-claude-code-plugins970—~5.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Teach

    cursor/plugins

    Official

    Explain a body of work plainly so a person actually understands it.

    11k GitHub starsUsed in 9 repos~1.4k tokens
    EducationAuto-check passed
  • Crossframe Teach

    sickn33/agentic-awesome-skills

    A skill your agent uses when CrossFrame Suite routes explicit Chinese teaching of CrossFrame concepts, misreading boundaries, plain-language examples, signals, or exercises.

    47k GitHub starsUsed in 1 repo~943 tokens
    Writing & ContentAuto-check passed
  • Teach

    vinvcn/mattpocock-skills-zh-CN

    在这个工作区中教用户一个新技能或概念。

    4.7k GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Generic Assistant

    mastra-ai/mastra

    Fallback authoring playbook for building general-purpose personal assistant agents that do not fit a more specific archetype.

    29k GitHub stars~1.1k tokensUpdated today
    Sales & SupportAuto-check passed
  • Teach

    ccplugins/awesome-claude-code-plugins

    Teaches the Second Brain to recognize a new external data source.

    970 GitHub stars~5.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Official

    Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs.

    207k GitHub stars~550 tokensUpdated today
    Productivity & AutomationAuto-check passed

More from jwynia/agent-skills

All 111 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    170 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check: notes
  • Frontend Design

    jwynia/agent-skills

    Create distinctive, production-grade frontend interfaces with high design quality.

    170 GitHub stars~3.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Gitea Workflow

    jwynia/agent-skills

    Orchestrate agile development workflows for Gitea repositories using the tea CLI.

    170 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Godot Asset Generator

    jwynia/agent-skills

    Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.

    170 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Mastra Hono

    jwynia/agent-skills

    Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.

    170 GitHub stars~2.9k tokensUpdated 7 mo ago
    Auto-check passed
  • PPTX Generator

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

    170 GitHub stars~3.1k tokensUpdated 7 mo ago
    Auto-check passed

Questions about Gentle Teaching

What does Gentle Teaching do?

Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries. Gentle Teaching is an agent skill from jwynia/agent-skills. Guide AI-assisted learning that empowers learners while maintaining appropriate boundaries.

When should I use Gentle Teaching?

Gentle Teaching fits situations like: explaining concepts; helping someone who is struggling to understand.

How do I install Gentle Teaching in Claude Code?

Run `npx skills add jwynia/agent-skills --skill gentle-teaching -a claude-code`. Or copy the skill folder (skills/general/education/gentle-teaching in jwynia/agent-skills) into .claude/skills/gentle-teaching in your project. Claude Code loads it when a task matches its description.

How do I install Gentle Teaching in Codex?

Run `npx skills add jwynia/agent-skills --skill gentle-teaching -a codex`. Or copy the skill folder (skills/general/education/gentle-teaching in jwynia/agent-skills) into .agents/skills/gentle-teaching in your project. Codex loads it when a task matches its description.

Can I use Gentle Teaching in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill gentle-teaching -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gentle-teaching, .gemini/skills/gentle-teaching, .github/skills/gentle-teaching and .opencode/skills/gentle-teaching in your project.

What does Gentle Teaching need to run?

SKILL.md names no scripts, command-line tools or credentials: Gentle Teaching is instructions for the agent only.

Does Gentle Teaching access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gentle Teaching safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gentle Teaching use?

Gentle Teaching is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gentle Teaching use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gentle Teaching?

Skills that share tags, products or a category with Gentle Teaching: Teach (cursor/plugins, 11k stars), Crossframe Teach (sickn33/agentic-awesome-skills, 47k stars), Teach (vinvcn/mattpocock-skills-zh-CN, 4.7k stars) and Generic Assistant (mastra-ai/mastra, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gentle Teaching?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on February 24, 2026.

Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.