About

Imported from shipshitdev/skills (skills/teach/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill teach. Copyright stays with the author (MIT).

Teach

Name: teach
Author: shipshitdev

Explain what a thing is, how it works, and why it is built that way, in one plain account at the person's pace. Change nothing.

Authorized Scope

Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates.

Contract

Inputs:

A change, subsystem, or concept the person wants to understand

Outputs:

The explanation itself, never a report about what you delivered

Creates/Modifies:

None

External Side Effects:

None beyond the read-only work how and why do

Confirmation Required:

None

Delegates To:

how and why for investigation. Do not redo their digging.

Steps

Decide the few things they should walk away understanding, from why they are asking and what they already know. Do not quiz them.
Let how and why do the work. Run them in parallel when both matter. Keep why narrow by default. Keep why's confidence language intact.
Start with a plain definition. Then tie it to the case in front of you. Give the smallest complete answer first, a sentence or two, then stop. Add layers when they ask.
Keep it a conversation. No quizzes. No pacing theater. No "the key insight" labels.
Show, don't only tell. For three or more moving parts, draw a short series of diagrams that each add one part. Mermaid for flows. Skip a figure that only decorates.

Apply references/prose-slop.md from the selected deslop skill directory. Give each concept one name and keep it.

Reply: the explanation. Lead with the main point, then what it is, how it works, and why.

Teach procedure

Read teach procedure when running this workflow. Apply the authorized scope and mode of this entry point to every step. Resolve other skills through this distribution’s active catalog; resolve resources relative to the installed skill directory.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-teach/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-teach.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-teach",
  "kind": "skill",
  "name": "teach",
  "description": "Explain a body of work so a person actually understands it. Runs how and why and weaves what they find into one plain explanation, built up diagram by diagram. Use for teach me this, help me really understand X, or explain this change or subsystem.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "teaching",
      "explanation",
      "onboarding",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Explain a body of work so a person actually understands it. Runs how and why and weaves what they find into one plain explanation, built up diagram by diagram. Use for teach me this, help me really understand X, or explain this change or subsystem."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/teach/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/teach/SKILL.md",
      "key": "shipshitdev/skills/skills/teach/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Teach\n\nExplain what a thing is, how it works, and why it is built that way,\nin one plain account at the person's pace. Change nothing.\n\n## Authorized Scope\n\nApply this engine only within the user's requested task and existing explicit\nauthorization. Loading or delegating to it grants no additional authority.\nPreserve report-only restrictions and the caller's target, host, provider, and\ncost limits. Existing approval satisfies a gate only for the same actions and\nscope; obtain approval before expanding them. Forward these limits to delegates.\n\n## Contract\n\nInputs:\n\n- A change, subsystem, or c",
  "cost": {
    "context_tokens": 546
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-teach/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.