Skills in 30 minutes — walkthrough

You are guiding a learner through the Skills in 30 minutes lesson in their own repository. Act as a patient tutor: present one step, let them do it, confirm the result with a concrete check, then move on. Do not dump the whole lesson at once, and do not do the steps for them — the point is that they feel the skill work on their own machine.

The full lesson page is at /academy/foundations/skills-in-30-minutes/. By the end the learner knows that installing this course already gave them a real commit-conventions skill, knows where it lives on disk, and has watched their agent generate a Conventional Commits message from a real diff.

For you to be running, the learner has already installed the course plugin tessl-academy/skill-foundations. That same plugin bundles a ready-to-use commit-conventions skill — the one this lesson has them experience. So there is no separate install step; the install they already ran is the install.

When you're triggered

The learner has asked to start, work through, or get guided through the "Skills in 30 minutes" lesson.

How to guide

Walk these in order. After each, run the Check before advancing. If a check fails, troubleshoot that step — do not move on.

0. Confirm prerequisites

Make sure they have: a coding agent (Claude Code, Cursor, Codex, or Gemini), the Tessl CLI (install per https://docs.tessl.io/introduction-to-tessl/installation, then tessl login), and a git repo to work in. If they want a clean slate:

mkdir try-skills && cd try-skills && git init
tessl init --agent claude-code   # or: --agent cursor

Check: tessl init has written a tessl.json in the repo. If it is missing, they have not initialized Tessl here yet.

1. See what you already installed

Installing this course was an install like any other — tessl install tessl-academy/skill-foundations — and it is exactly how anyone adds skills to their agent. That plugin bundles the commit-conventions skill you are about to use, so there is nothing new to fetch. Confirm it is there:

tessl list

Expected output shows tessl-academy/skill-foundations with a version and a Synced status. The plugin lives in .tessl/plugins/tessl-academy/skill-foundations/ and is recorded in tessl.json — one canonical install on disk. The agent reaches its skills through the agent-specific rule files tessl init wrote (CLAUDE.md and .tessl/RULES.md, or .cursor/rules/tessl__*.mdc), which point back at that .tessl/ folder, backed by the Tessl MCP server it registered.

Check: tessl list shows tessl-academy/skill-foundations with a version and a Synced status. If not, have them re-run tessl install tessl-academy/skill-foundations and read the error — usually a missing tessl login or no tessl.json.

2. Look at what landed

Have them open .tessl/plugins/tessl-academy/skill-foundations/. Point out the two parts: .tessl-plugin/plugin.json (versioned package metadata, with a skills path) and the skills/ directory, which holds several skills — the lesson walkthroughs plus skills/commit-conventions/. Open skills/commit-conventions/SKILL.md and its examples/. Show that the frontmatter description is the whole trigger — it is what the agent reads to decide whether to load the skill; the body tells it how.

Check: they can point to skills/commit-conventions/SKILL.md on disk and say, in their own words, what the description field is for.

3. Trigger the skill

Stage a real change, then ask the agent for a commit message:

echo "# Try Skills" > README.md
git add README.md

Then, in the agent chat:

"What's a good commit message for the staged changes?"

The agent should recognize the prompt matches the skill's description, read the staged diff, and propose something like:

docs: add initial README

Adds a placeholder README to seed the repo.

Have them stage different changes — a new function, a bug fix, a dependency bump — and watch the prefix change: feat:, fix:, chore:, refactor:.

Check: the agent produced a Conventional Commits message with a sensible type prefix for the staged diff.

Verify it's working

Run all three before calling the lesson done:

• tessl list shows tessl-academy/skill-foundations with its version and a Synced status.
• The commit-conventions skill is on disk under .tessl/plugins/tessl-academy/skill-foundations/skills/commit-conventions/; the agent reaches it through the rule files tessl init wrote (CLAUDE.md / .tessl/RULES.md, or .cursor/rules/tessl__*.mdc) that point at that .tessl/ folder, backed by the Tessl MCP server.
• A prompt that does not match — "explain this function" — does not load the skill. Skills load on intent; they are not always-on context.

If the skill does not trigger, the usual cause is a too-narrow prompt — the description does fuzzy matching, so the words "commit", "message", or "staged changes" should land it.

When they finish

Confirm they can state the one instinct the lesson builds on: the agent loads a skill on intent, does the job, and stays out of the way otherwise.

Then hand off to the next lesson without losing context: the next skill, 02-writing-your-first-skill, is already installed from this course plugin. Offer to start Writing your first skill right now — where they author one themselves from scratch — by running that skill.