Agent skill

Authoring Tutorials Examples

by ISET in ISET/isetcam

A skill your agent uses when adding, editing, or deciding where to place a file in tutorials/ or examples/, when naming a new t.m, s.m, or data.m script, or when asked about the difference between a…

MITAuto-check passed

Install Authoring Tutorials Examples

skills CLI
$ npx skills add ISET/isetcam --skill authoring-tutorials-examples -a claude-code

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

GitHub CLI
$ gh skill install ISET/isetcam authoring-tutorials-examples --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/ISET/isetcam.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/authoring-tutorials-examples .claude/skills/authoring-tutorials-examples && 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
authoring-tutorials-examples
GitHub stars
176
Token cost
~810 tokens
SKILL.md length
371 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding, editing, or deciding where to place a file in tutorials/ or examples/, when naming a new t.m, s.m, or data.m script, or when asked about the difference between a…

  • Deciding where to place a file in tutorials/
  • SKILL.md covers Tutorials (tutorials/, t_*.m), Examples (examples/, s_*.m), Data-Generation Scripts… and Student Contributors, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Naming a new t.m

What it does

Authoring Tutorials Examples is an agent skill from ISET/isetcam. Use when adding, editing, or deciding where to place a file in tutorials/ or examples/, when naming a new t.m, s.m, or data.m script, or when asked about the difference between a tutorial and an example in ISETCam.

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

The repository describes itself as: Open source version of the original ISET, a complement to ISETBIO. The licence is MIT.

When your agent uses it

  • Deciding where to place a file in tutorials/
  • Naming a new t.m
  • Asked about the difference between a tutorial and an example in ISETCam

Example prompts

  • “/authoring-tutorials-examples”

What it can do on your machine

Read from SKILL.md and the folder at commit 17146a9. 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 (its code samples are matlab).

    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

Authoring Tutorials Examples loads about 810 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 371 words of instructions outside code blocks.

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

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 ISET/isetcam at commit 17146a9, republished under its MIT licence (© ISET). 371 words, ~810 tokens.

Download SKILL.mdSave it as .claude/skills/authoring-tutorials-examples/SKILL.md (or your agent's skills folder).
name
authoring-tutorials-examples
description
Use when adding, editing, or deciding where to place a file in tutorials/ or examples/, when naming a new t_*.m, s_*.m, or data_*.m script, or when asked about the difference between a tutorial and an example in ISETCam.

Authoring Tutorials and Examples

ISETCam keeps tutorials/ and examples/ as separate teaching surfaces for different goals and audiences. Preserve this distinction when adding or editing files.

Tutorials (tutorials/, t_*.m)

  • Audience: learners (including new students) who can program and are learning image systems engineering and ISETCam object fundamentals.
  • Purpose: short, heavily commented introductions to key objects and APIs.
  • Expected content:
    • object creation and setup
    • *Get/*Set usage for key properties
    • basic visualization (*Window, *Plot)
    • one simple quantitative computation/checkpoint
  • Expected behavior: runs relatively quickly and is easy to read linearly.

Examples (examples/, s_*.m)

  • Audience: users looking for realistic analysis patterns to adapt.
  • Purpose: applied workflows and more advanced computations using ISETCam.
  • Expected content:
    • end-to-end numerical analyses or visualization workflows
    • realistic parameter choices and tradeoff exploration
    • code that users may copy/adapt as a starting point for their own work
  • Expected behavior: can be longer and more detailed than tutorials.

If content is mainly onboarding and API orientation, place it in tutorials/. If content is mainly applied workflow, analysis, or deeper exploration, place it in examples/.

Data-Generation Scripts (data_*.m)

Some scripts exist to generate or refresh repository data files rather than to serve as tutorials or examples. Name these scripts data_*.m. This distinguishes them from the automated tutorial (t_*.m) and example (s_*.m) smoke-test sources discovered by the test runners, and makes their side-effecting purpose explicit.

Show full SKILL.md (151 more words)Show less

Student Contributors

For student contributors, prioritize clarity, reproducibility, and instructional value: use clear comments, stable outputs, and explicit links to related wiki pages, tests, and nearby tutorials/examples.

Excluding a File From Automated Smoke Runs

ieTutorialTest and ieExampleTest execute every t_* and s_* file by default. To opt a file out, add this exact comment anywhere in the file:

matlab
% SkipFile

Use sparingly — for files needing unavailable external data/toolboxes, deliberate user interaction, unusually expensive computation, or a known, documented failure. Remove the tag once the file is suitable for routine automated execution. See the testing-workflow skill for the full marker contract and the legacy % UTTBSkip compatibility note.

Reviewing Existing Scripts

To review scripts under examples/* or tutorials/* for runnability, comment quality, overlap, and coverage against nearby _tests_ directories, use the existing matlab-script-review agent (.github/agents/matlab-script-review.agent.md) rather than re-deriving that workflow here.

Publishing

To convert a tutorial or example into linkable HTML, see the publishing-tutorials-examples skill.

© ISET, 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 .github/skills/authoring-tutorials-examples of ISET/isetcam.

Open the folder on GitHubat commit 17146a9

Compare with similar skills

Authoring Tutorials Examples 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.

Authoring Tutorials Examples compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Authoring Tutorials Examples this skillISET/isetcam176—~810Automated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Configuring Oauth2 Authorization Flowmukul975/Anthropic-Cybersecurity-Skills34k—~1.7kAutomated safety check: PassApache-2.0
Authoring Skillsvercel/next.js143k—~1kAutomated safety check: PassMIT
Abp Authorizationabpframework/abp14k—~1.3kAutomated safety check: PassLGPL-3.0
Implementing GCP Binary Authorizationmukul975/Anthropic-Cybersecurity-Skills34k—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Authoring Skills

    vercel/next.js

    Official

    How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.

    143k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Abp Authorization

    abpframework/abp

    ABP permission system - PermissionDefinitionProvider, [Authorize] attribute, CheckPolicyAsync, IsGrantedAsync, ICurrentUser, IPermissionManager, multi-tenancy side.

    14k GitHub stars~1.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Implementing GCP Binary Authorization

    mukul975/Anthropic-Cybersecurity-Skills

    Implements GCP Binary Authorization end to end, including creating KMS-backed attestors, Container Analysis notes, deploy-time policies, and signing image attestations, so that only trusted…

    34k GitHub stars~2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Collectors Authoring

    netdata/netdata

    Author, modify, or review Netdata collectors across Go, IBM, C, Rust and external plugins.

    81k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from ISET/isetcam

  • A skill your agent uses when setting up or troubleshooting a MATLAB session for this repository — configuring the VS Code MATLAB extension, MATLAB Desktop vs.

    176 GitHub stars~1.3k tokensUpdated 12 days ago
    Auto-check passed
  • Matlab Evaluation

    ISET/isetcam

    A skill your agent uses when running, testing, or publishing MATLAB .m scripts from ISETCam or the local Psych 221 teaching repository in a non-interactive MATLAB session, including locating MATLAB…

    176 GitHub stars~1.2k tokensUpdated 12 days ago
    Auto-check passed
  • A skill your agent uses when converting an ISETCam tutorial or example .m file into a self-contained HTML file for a wiki page — iePublish, spublishTutorials, spublishExamples, embedding figures or…

    176 GitHub stars~1.4k tokensUpdated 12 days ago
    Auto-check passed
  • A skill your agent uses when modifying the shared ieRunTutorialExampleTests engine, changing the canonical run-record/checkpoint schema, adding a thin tutorial/example test wrapper for a new…

    176 GitHub stars~2.6k tokensUpdated 12 days ago
    Auto-check passed
  • Testing Workflow

    ISET/isetcam

    A skill your agent uses when running or choosing ISETCam tests after a code change — ieUnitTest, ieTutorialTest, ieExampleTest, ieTestReport, selecting/starting a partial run, the % SkipFile marker…

    176 GitHub stars~1.4k tokensUpdated 12 days ago
    Auto-check passed

Questions about Authoring Tutorials Examples

What does Authoring Tutorials Examples do?

A skill your agent uses when adding, editing, or deciding where to place a file in tutorials/ or examples/, when naming a new t.m, s.m, or data.m script, or when asked about the difference between a…. Authoring Tutorials Examples is an agent skill from ISET/isetcam.m script, or when asked about the difference between a tutorial and an example in ISETCam.

When should I use Authoring Tutorials Examples?

Authoring Tutorials Examples fits situations like: deciding where to place a file in tutorials/; naming a new t.m; asked about the difference between a tutorial and an example in ISETCam.

How do I install Authoring Tutorials Examples in Claude Code?

Run `npx skills add ISET/isetcam --skill authoring-tutorials-examples -a claude-code`. Or copy the skill folder (.github/skills/authoring-tutorials-examples in ISET/isetcam) into .claude/skills/authoring-tutorials-examples in your project. Claude Code loads it when a task matches its description.

How do I install Authoring Tutorials Examples in Codex?

Run `npx skills add ISET/isetcam --skill authoring-tutorials-examples -a codex`. Or copy the skill folder (.github/skills/authoring-tutorials-examples in ISET/isetcam) into .agents/skills/authoring-tutorials-examples in your project. Codex loads it when a task matches its description.

Can I use Authoring Tutorials Examples 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 ISET/isetcam --skill authoring-tutorials-examples -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/authoring-tutorials-examples, .gemini/skills/authoring-tutorials-examples, .github/skills/authoring-tutorials-examples and .opencode/skills/authoring-tutorials-examples in your project.

What does Authoring Tutorials Examples need to run?

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

Does Authoring Tutorials Examples 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 Authoring Tutorials Examples 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 Authoring Tutorials Examples use?

Authoring Tutorials Examples is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Authoring Tutorials Examples use?

About 810 tokens (SKILL.md is roughly 3.2k 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 Authoring Tutorials Examples?

Skills that share tags, products or a category with Authoring Tutorials Examples: Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars), Configuring Oauth2 Authorization Flow (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Authoring Skills (vercel/next.js, 143k stars) and Abp Authorization (abpframework/abp, 14k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Authoring Tutorials Examples?

ISET (a GitHub organization) maintains it in ISET/isetcam, which has 176 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on September 25, 2026.

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