Skip to content

Guide · Agent skill

How to use the Skill Creation Assistant agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The Skill Creation Assistant is a set of instructions that teaches DeepTutor's chat agent how to help you write a new skill. A skill is a reusable playbook the agent loads only when it is relevant to your request. This guide explains what the skill does, how to install it, how to trigger it, and what to watch for, so you can turn a repeated workflow into a skill you can review and keep.

Skill Creation AssistantHKUDS/DeepTutor · Apache-2.0

Quick start

  1. 1Install the skill. Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
  2. 2Confirm requirements. Make sure you are using the DeepTutor runtime with its chat agent and that the read_skill and propose_creation tools are available.
  3. 3Describe the workflow. Tell the agent in plain language what repeated task you want turned into a skill, who it is for, and what a good result looks like.
  4. 4Answer the one question if asked. The agent may ask a single short question. If it does not, it will infer sensible defaults and draft straight away.
  5. 5Review the preview card. Read the proposed name, trigger description, and instructions on the draft card before deciding anything.
  6. 6Request edits or confirm. Ask for changes in ordinary words to get a revised card under the same name, or confirm the draft when it is right.

What a skill is and what this skill makes the agent do

A skill is a reusable playbook: step-by-step instructions the chat agent reads on demand with its read_skill tool. The agent only sees each skill's name and description in its system prompt, so the description acts as the trigger that tells it when the skill applies.

When this skill is active, the agent asks at most one short question if a key detail is missing. Otherwise it infers sensible defaults and drafts a skill with a clear name, a trigger description, step-by-step instructions, and optional reference files. It calls propose_creation to show the draft as a card. Nothing is saved automatically; you edit or confirm the card.

  • Drafts a name and a trigger description
  • Writes instructions as ordered steps with concrete examples and edge cases
  • Moves large reference material into references/*.md files
  • Shows the draft as a preview card for you to edit or confirm

Install the skill from the ZIP or the Claude apps

Download the ZIP from this page and unzip it into one of two locations. Use ~/.claude/skills/ to make it available across your projects, or a project's .claude/skills/ folder to limit it to that project.

If you use the Claude apps instead, upload the skill under Settings → Capabilities → Skills.

  • Personal: unzip into ~/.claude/skills/
  • Project only: unzip into .claude/skills/ inside the project folder
  • Claude apps: Settings → Capabilities → Skills, then upload

Requirements before you start

This skill needs the DeepTutor runtime with its chat agent, plus the read_skill and propose_creation tools. It does not run scripts and does not use the network. It works from your plain-language description and any materials you share in the conversation, using the agent's other tools such as web search, knowledge base, or attachments when you provide them.

  • DeepTutor runtime with its chat agent
  • read_skill and propose_creation tools available
  • Runs scripts: no
  • Uses network: no

How to trigger it with natural requests

Ask the agent in plain language to create, write, or draft a skill for a workflow you repeat. Describe the task, who it is for, and what a good result looks like. You can include examples or attach material for the agent to use.

The agent writes the draft in the same language you use. Once the card appears, ask for changes in ordinary words and the agent revises the draft under the same name.

  • "Make a skill that turns my lecture notes into a five-question quiz."
  • "Create a reusable skill for checking citations in my essays against a reference list."
  • "Draft a skill for summarising a chapter in the format I use for study guides."

Skills versus Personas: what this skill is not for

This skill is for multi-step workflows. If you want to set a tone or personality, such as always answering like a strict tutor, that is a Persona, not a Skill. The skill file tells the agent to explain this briefly and not force the request into a skill.

Because the drafting step only produces a preview card, a skill is never saved automatically. If you need one saved without review, this skill is not the right fit.

  • Use a Skill for repeatable procedures and task playbooks
  • Use a Persona for tone, style, and behaviour settings

Safety notes: scripts and network access

According to the listing, this skill runs no scripts and uses no network access. Its output is a text draft shown to you on a card. Review the name, description, and instructions before you confirm, since the draft becomes a skill only after you accept it.

Check any reference files the agent proposes as well, because they become part of the skill's content once saved.

  • No scripts are run by this skill
  • No network access is used by this skill
  • Review every draft card before confirming

What people use it for

  • Turning a repeated study workflow, such as building quiz questions from notes, into a reusable skill
  • Creating a structured drafting process for custom agent behaviours in DeepTutor
  • Getting a proposed skill structure from a plain-language description when you are new to skills
  • Splitting long reference material such as schemas or lookup tables into reference files the skill points to

Frequently asked questions

Is the Skill Creation Assistant free to use?

The source gives the licence as Apache-2.0 for the HKUDS/DeepTutor project, and this skill is listed under that licence. The source does not mention prices, so check the licence and the project page for the terms that apply to you.

How do I install the Skill Creation Assistant?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can upload it under Settings → Capabilities → Skills.

What do I need to run this skill?

You need the DeepTutor runtime with its chat agent, plus the read_skill and propose_creation tools. The skill runs no scripts and uses no network access.

Will the skill save my new skill automatically?

No. The propose_creation tool only generates a draft card. You edit or confirm the card, and the agent is instructed never to claim that anything has been saved.

What is the difference between a Skill and a Persona?

A Skill is a step-by-step playbook the agent loads when relevant. A Persona sets tone or personality and is injected into the system prompt for conversations that select it. If you want a tone such as a strict tutor, a Persona is the right choice.

Why did the agent not create a skill from my tone request?

The skill instructions say tone and style presets belong to a Persona, not a Skill. The agent is told to explain this briefly rather than force the request into a skill.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits DeepTutor users and developers who want to turn a repeated workflow into a reusable skill, and non-experts who want a proposed structure from a plain-language description. It is not suited to setting a tone or personality, which belongs in a Persona, or to anyone who needs skills saved automatically without reviewing a draft.

Download the skill