Index of every page on this site: llms.txt
All skills
onmax avatar

/teach-lesson

@aecfada
by Maxonmax/comark-ui43 stars
3
Run it yourself

Writes a short lesson on one concept in simplified English, with a worked example and a question the reader answers. Use when someone asks to learn or understand one concept, wants a tutorial or self-check they can test themselves on, or needs onboarding on one idea.

Use this Skill: https://skilld.dev/gh/onmax/comark-ui/teach-lesson

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesblocks.md

≈727 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Blocks for a lesson

These blocks come with comark-ui. The steps and questions also come separately with comark-steps and comark-quiz.

The worked example: ::steps

::steps
### Both load version 7

Ana and Ben each `GET /articles/42`, and both get `ETag: "v7"`.

### Ana saves first

```http
PUT /articles/42
If-Match: "v7"
```
::

Each ### heading starts a step that holds everything up to the next one, code blocks included. Put any introduction above the block; content before the first heading renders above the steps and is reported. For steps of one line each, a numbered list inside ::steps works too.

Build a diagram across steps

Use a mermaid fence when a diagram helps explain interacting parts. At each move, redraw the previous diagram with one more part or relationship, and keep its labels and participant order.

Use numbered Markdown headings for the worked example. Mermaid fences currently disappear inside ::steps, so place them directly under these headings:

### 1. The client requests the article

```mermaid
sequenceDiagram
  participant Client
  participant Server
  Client->>Server: GET /articles/42
```

### 2. The server returns a version label

```mermaid
sequenceDiagram
  participant Client
  participant Server
  Client->>Server: GET /articles/42
  Server-->>Client: ETag v7
```

These paths and version labels are illustrative. Use sequenceDiagram for messages or flowchart LR for a flow.

The check: ::question

::question{#etag-no-if-match}
Ben's editor sends his `PUT` with no `If-Match` header. What happens?

- [x] The server saves Ben's version and Ana's fix is lost
  > Without `If-Match` there's no condition to fail.
- [ ] The server refuses the save with a 412 status code
  > A 412 needs a condition that failed.

#hint
What does the server compare the label against?

#explain
`If-Match` is opt-in.
::
  • Mark each right option [x]. One [x] makes radio buttons and several make checkboxes. Add multiple to show checkboxes even with one right option.
  • The > quote under an option is its rationale, shown once the reader answers.
  • #hint is optional and opens on request. #explain opens after the right answer or Show answer, not after a wrong pick.
  • Options are shuffled the same way on every render. Write shuffle="false" only when their order means something, such as numbers in order.
  • Give the block an #id so a host can store the answer. Without one, the id comes from the question's text and changes when you edit it.

Without its script, the question and an answer disclosure still render as plain HTML.

The fact to keep: ::recall

::recall{#etag-412}
What does a server answer when `If-Match` names an old version?

#answer
`412 Precondition Failed`, and it leaves the resource unchanged.
::

The reader answers in their head, then reveals #answer.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning20d3 checks · Risk MEDIUM
  • Gen Agent Trust Hub20d

    This skill instructs the agent to download and execute unversioned Node.js packages from a non-standard source using the `dlx` command. It also involves running shell commands on content generated from external data, which presents a surface for indirect prompt injection.

  • Socket20d

    No alerts

  • Snyk20d

    Risk: LOW · No issues

Signed by skilld at aecfada. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago

README badge

README badge for onmax/comark-ui/teach-lesson