mcpbeat

Source Manifest

willoscar/source-manifest

| Build or validate the source manifest for the source-tutorial pipeline from user-provided URLs/files.

2k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
496
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill source-manifest

What comes with it

4 315 bytes besides the instruction
scripts/run.py

The instruction itself

11 sections, as written by the author

Source Manifest

Goal: collect the source candidates for source-tutorial into one explicit manifest before ingest starts.

Inputs

  • GOAL.md
  • DECISIONS.md

Outputs

  • sources/manifest.yml

Workflow

  • Read GOAL.md and any existing DECISIONS.md notes to understand what kinds of sources the tutorial is expected to use.
  • If sources/manifest.yml does not exist, scaffold it with a minimal example.
  • Validate that each source has:
  • source_id
  • kind
  • locator
  • label
  • for kind: video, prefer transcript_locator unless the platform exposes public subtitles
  • Reject placeholder/example-only manifests.
  • Return success only when at least one real source exists.

Accepted kind

  • webpage
  • pdf
  • markdown
  • repo
  • docs_site
  • video

For video:

  • preferred: add transcript_locator
  • Bilibili may succeed from public subtitles when available
  • YouTube should currently be paired with transcript_locator

Script

Quick Start

  • uv run python .codex/skills/source-manifest/scripts/run.py --workspace <workspace>

All Options

  • --workspace <dir> (required)
  • --unit-id <U###>
  • --inputs <semicolon-separated>
  • --outputs <semicolon-separated>
  • --checkpoint <C#>

Examples

  • Scaffold or validate the manifest:
  • uv run python .codex/skills/source-manifest/scripts/run.py --workspace <workspace>

Troubleshooting

Issue: the unit keeps blocking after scaffold

Cause:

  • The manifest still contains example placeholders.

Fix:

  • Replace the scaffold entry with real URLs or local file paths, then rerun the unit.

How to use it

Copy the folder

Take willoscar/source-manifest from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.