Skip to content
OpenSmartRoute
Skillv1.0.0

scaffold-exercises

Use when creating exercise directory structures with problems, solutions, and explainers

by LoopyLuci(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from LoopyLuci/Skills (skills/scaffold-exercises/SKILL.md). Install upstream with npx skills add LoopyLuci/Skills --skill scaffold-exercises. Copyright stays with the author.

Scaffold Exercises

Create exercise directory structures that pass linting validation, then commit.

Directory naming

  • Sections: XX-section-name/ inside exercises/
  • Exercises: XX.YY-exercise-name/ inside a section
  • Names are dash-case (lowercase, hyphens)

Exercise variants

Each exercise needs at least one subfolder:

  • problem/ - student workspace with TODOs
  • solution/ - reference implementation
  • explainer/ - conceptual material, no TODOs

Required files

Each variant folder needs a non-empty readme.md with real content. If the subfolder has code, it also needs a main.ts (>1 line).

Workflow

  1. Parse the plan - extract section names, exercise names, and variant types
  2. Create directories with mkdir -p
  3. Create stub readmes with title and description
  4. Run lint to validate
  5. Fix any errors until lint passes

Common Pitfalls

  • Empty readme files: Each variant folder's readme.md must have real content. An empty or near-empty readme fails linting.
  • Wrong directory naming convention: Sections are XX-section-name, exercises are XX.YY-exercise-name. Wrong naming fails the linter.
  • Not running lint after creation: Always run the linter after scaffolding. Fix errors before committing.

Verification Checklist

  • Section directories follow XX-section-name convention
  • Exercise directories follow XX.YY-exercise-name convention
  • Each variant folder has non-empty readme.md
  • Code files have main.ts if needed
  • Lint passes

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/loopyluci-skills-scaffold-exercises/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.

loopyluci-skills-scaffold-exercises.ocm.jsonjson
{
  "ocm": "1",
  "id": "loopyluci-skills-scaffold-exercises",
  "kind": "skill",
  "name": "scaffold-exercises",
  "description": "Use when creating exercise directory structures with problems, solutions, and explainers",
  "publisher": "LoopyLuci",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "scaffolding",
      "exercises",
      "education",
      "structure",
      "linting",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when creating exercise directory structures with problems, solutions, and explainers"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/LoopyLuci/Skills",
      "path": "skills/scaffold-exercises/SKILL.md",
      "ref": "6f9faf8a3a216cddd3eda96a6c6b93c00710fa5b",
      "url": "https://github.com/LoopyLuci/Skills/blob/6f9faf8a3a216cddd3eda96a6c6b93c00710fa5b/skills/scaffold-exercises/SKILL.md",
      "key": "LoopyLuci/Skills/skills/scaffold-exercises/SKILL.md"
    }
  },
  "instructions": "# Scaffold Exercises\n\nCreate exercise directory structures that pass linting validation, then commit.\n\n## Directory naming\n- Sections: `XX-section-name/` inside exercises/\n- Exercises: `XX.YY-exercise-name/` inside a section\n- Names are dash-case (lowercase, hyphens)\n\n## Exercise variants\nEach exercise needs at least one subfolder:\n- `problem/` - student workspace with TODOs\n- `solution/` - reference implementation\n- `explainer/` - conceptual material, no TODOs\n\n## Required files\nEach variant folder needs a non-empty readme.md with real content. If the subfolder has code, it also needs a main.",
  "cost": {
    "context_tokens": 376
  }
}

Fetch it by URL: GET /api/v1/registry/loopyluci-skills-scaffold-exercises/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.