needs-analysis SKILL.md skillA

needs-analysis from savvides/idstack is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add savvides/idstack/needs-analysis@git:20261102.950ac90

Pins git:20261102.950ac90 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
savvides/idstack
Path
skills/needs-analysis/SKILL.md
Versions recorded
19
Latest version
git:20261102.950ac90, committed Nov 2, 2026
First version recorded
Aug 5, 2026
Size
66,248 bytes
Repository stars
27
License
MIT

Evidence-based three-level needs assessment for instructional design: organizational, task, and learner analysis before you design a course. Creates the shared project manifest that /idstack:learning-objectives, /idstack:course-quality-review, and the other skills read and extend. Use when starting a new course design, or when asked for a needs analysis or a learner analysis. (idstack).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<!-- AUTO-GENERATED from SKILL.md.tmpl -- do not edit directly -->
<!-- Edit the .tmpl file instead. Regenerate: bin/idstack-gen-skills -->

## Preamble: Interaction Conventions

idstack runs only in Claude Code. Skill bodies name these Claude Code tools:

- **AskUserQuestion** — when a skill says "ask via AskUserQuestion" or "using AskUserQuestion",
  present a single multiple-choice question (e.g., "Which of these best describes X?")
  and stop, waiting for the user's answer before proceeding. Ask **one** question at a time,
  never batch. This maps to the `AskUserQuestion` tool. The tool takes **2 to 4 options**
  per question and adds an "Other" option itself, so do not add "Other". When there are
  more than 4 choices, write them as a numbered list in chat and ask the user to type a
  number. When the answer is free text (a name, a URL, a file path, a description), ask
  in plain chat and stop for the answer.
- **Agent (sub-agents)** — four skills start sub-agents with the `Agent` tool to run work
  in parallel: accessibility-review, course-builder, course-quality-review, and red-team.
  The written-out steps after each dispatch define the work. If a sub-agent fails or
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add savvides/idstack/needs-analysis@sha256:7c7864e0634e27b9

The line at the top of this page pins the label git:20261102.950ac90, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mjk262jaznzikff7.svg)](https://markdownregistry.com/a/art_mjk262jaznzikff7)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 19 versions of this file, between Aug 5, 2026 and Nov 2, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261102.950ac90 latest2026-11-02 950ac90 66,248 BA view · diff
git:20261101.e7318072026-11-01 e731807 55,647 BA view · diff
git:20261101.4693ad82026-11-01 4693ad8 55,577 BA view · diff
git:20261101.ad680532026-11-01 ad68053 54,606 BA view · diff
git:20261101.0606b112026-11-01 0606b11 55,882 BA view · diff
git:20261008.54932452026-10-08 5493245 62,535 BA view · diff
git:20261008.2e8eacd2026-10-08 2e8eacd 62,522 BA view · diff
git:20261008.603e9cc2026-10-08 603e9cc 62,257 BA view · diff
git:20261008.f0611342026-10-08 f061134 62,257 BA view · diff
git:20261008.9a24b072026-10-08 9a24b07 61,871 BA view · diff
git:20261004.69851b22026-10-04 69851b2 60,506 BA view · diff
git:20261003.47e74e22026-10-03 47e74e2 60,468 BA view · diff
git:20261003.7e610122026-10-03 7e61012 60,247 BA view · diff
git:20261003.18057e62026-10-03 18057e6 58,784 BA view · diff
git:20260913.2befca02026-09-13 2befca0 51,689 BA view · diff
git:20260806.68135322026-08-06 6813532 50,353 BA view · diff
git:20260806.6bf1eeb2026-08-06 6bf1eeb 50,309 BA view · diff
git:20260805.0b4ba512026-08-05 0b4ba51 51,430 BA view · diff
git:20260805.f9561772026-08-05 f956177 51,406 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (66248 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

savvides/idstack · 27 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mjk262jaznzikff7
GET https://markdownregistry.com/api/v1/resolve?ref=savvides/idstack/needs-analysis
GET https://markdownregistry.com/api/v1/blob/7c7864e0634e27b9466046921e95d102981958afdf7617e0bfcc5db38d1ab3d5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from savvides/idstack

CLAUDE.md CLAUDE.md file
savvides/idstack · CLAUDE.md
git:20261102.2eb5f9b · audit A · 27 stars
DESIGN.md DESIGN.md file
savvides/idstack · DESIGN.md
git:20261102.9d2ce40 · audit A · 27 stars
accessibility-review SKILL.md skill
savvides/idstack · skills/accessibility-review/SKILL.md · WCAG 2.1 AA compliance audit plus Universal Design for Learning (UDL 3.0) review for course designs. Two-tier output…
git:20261102.950ac90 · audit A · 27 stars
assessment-design SKILL.md skill
savvides/idstack · skills/assessment-design/SKILL.md · Evidence-based assessment design with rubrics, feedback strategies, and formative checkpoints. Aligns each assessment…
git:20261102.950ac90 · audit A · 27 stars
course-builder SKILL.md skill
savvides/idstack · skills/course-builder/SKILL.md · Generate complete course content from the idstack manifest: syllabus, module pages, assignment descriptions, and rubric…
git:20261102.950ac90 · audit A · 27 stars
course-export SKILL.md skill
savvides/idstack · skills/course-export/SKILL.md · Export course content to an LMS. Generates IMS Common Cartridge files (.imscc) for Canvas, Blackboard, Moodle, and D2L…
git:20261102.950ac90 · audit A · 27 stars
course-import SKILL.md skill
savvides/idstack · skills/course-import/SKILL.md · Course import from an LMS or a document. Reads IMS Common Cartridge files, SCORM packages, PDF or Word files, pasted…
git:20261102.950ac90 · audit A · 27 stars
course-quality-review SKILL.md skill
savvides/idstack · skills/course-quality-review/SKILL.md · Evidence-based course quality audit aligned with Quality Matters standards and the Community of Inquiry framework…
git:20261102.950ac90 · audit A · 27 stars
learn SKILL.md skill
savvides/idstack · skills/learn/SKILL.md · Manage the course-design learnings that idstack saved across sessions. Search, list, delete, promote, and export them…
git:20261102.950ac90 · audit A · 27 stars
learning-objectives SKILL.md skill
savvides/idstack · skills/learning-objectives/SKILL.md · Evidence-based learning objective development with revised Bloom's taxonomy classification and a bidirectional…
git:20261102.950ac90 · audit A · 27 stars
pipeline SKILL.md skill
savvides/idstack · skills/pipeline/SKILL.md · Pipeline orchestrator for idstack. Runs the skills from /idstack:needs-analysis to /idstack:course-export in the…
git:20261102.950ac90 · audit A · 27 stars
red-team SKILL.md skill
savvides/idstack · skills/red-team/SKILL.md · Adversarial course design audit across 5 dimensions: alignment stress test, evidence verification, cognitive load…
git:20261102.950ac90 · audit B · 27 stars

Every file in savvides/idstack

Browse by kind, by grade A, or by owner.