Jiang episode read writer

Skill apresmoi/jianglens/.codex/skills/jiang-episode-read-writer

Agentic Organization Research Project - Jiang Lens is an independent research and reading project built from Jiang Xueqin's lectures, interviews, and writing.

Install

npx -y skills add apresmoi/jianglens --skill jiang-episode-read-writer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use this skill when writing or revising the public Jiang Lens episode/interview read JSON for one already-ingested video, using its clean transcript and semantic bundle to create a compressed reader-facing public page.

SKILL.md

5.1 KB, as published. Nobody here has run it

Jiang Episode Read Writer

Use this after a source transcript and semantic outputs exist. The output is the public episode read:

content/lens/episodes/<source-slug>/read.json

This skill is editorial. It does not import Colab files, process transcript packets, rewrite lens docs, or promote canon.

Inputs

content/sources/videos/<source-slug>/transcripts/v1/transcript.clean.jsonl
content/lens/evidence/videos/<source-slug>.semantic.json
existing strong reads, especially content/lens/episodes/predictive-history-0hyet47cc-e/read.json
existing lens point IDs from compiled link index when adding lens links

Reading Pass

Before writing:

Read the full clean transcript, not only extracted claims.
Inspect semantic outputs for signature moments, real questions, quoted material, speaker uncertainty, and chronology notes.
Identify the episode's argumentative movement in one sentence.
Identify the sharpest Jiang formulations that must survive compression.
Check whether the episode directly invokes existing lens points.

Corpus Anchor Pass

Before finalizing the read, compare the source against the existing corpus:

strong prior episode reads, especially ones already curated by maintainers,
existing lens pages and lens-point anchors,
topic clusters and aliases,
semantic signature_moments from the current source,
prior Jiang phrases that sound close to this source.

Use the comparison to avoid two failures: a bland summary that loses Jiang's novelty, and an over-eager read that invents a new lens when the corpus already has a better home. If the source seems to mutate an existing concept or create a new reusable mechanism, mention that in the PR notes or handoff; do not create the lens page during ordinary episode work.

Public Read Contract

The page should read like a compact book chapter in Jiang's voice, not like a report about Jiang. For interviews, keep the question pressure and exchange context when that is what makes Jiang's answer intelligible.

Write:

title naming the central argument,
dek and thesis that state what is at stake,
an opening core reading,
5-8 chapter beats with timestamp ranges,
compact paragraphs carrying the argument,
paragraph-level refs and selective inline marks,
real student/interviewer/audience questions only,
optional source note only when it improves reader trust.

The episode or interview must be entry-point resilient. A reader who lands from search, a source link, or an evidence hover should understand what source this is, who Jiang is in this context, why it matters for the lens, and where to go for transcript/source inspection without needing to read /introduction first.

Do not write:

invented FAQ questions,
labels such as models, diagnoses, predictions, or source dossiers in the public read,
"Jiang discusses..." as the default sentence shape,
a transcript dump,
a skeletal summary that erases the lecture's strange pressure.

Signature Moment Rule

Preserve the memorable machinery of the lecture. If Jiang says poetry behaves like a virus, a guide becomes part of the trap, obedience becomes desire, memory resurrects what authority erased, or a story trains people into hell, keep that force visible.

At least three strong signature moments should appear in the title, dek, thesis, opening, beat headings, or paragraph prose when the source supports them. Tightening is allowed. Bureaucratizing is not.

Questions

questions means questions actually asked in the source transcript by a student, interviewer, audience member, or commenter.

If no real source question is captured:

"questions": []

Do not invent reader-facing prompts.

Marks And Lens Links

Use marks for exact phrases that should show source provenance or jump the video. Keep marked text narrow and meaningful.

Link to lens_points only when the phrase directly uses an existing public lens point:

{
  "text": "The guide is part of the trap.",
  "lens_points": ["lens-point:guide-trap-necessary-guide"],
  "refs": [
    "video:predictive-history-6m1z-v3wgok@transcript:v1#seg-0014"
  ]
}

Do not invent lens point IDs in an episode read.

Review Gate

Before handoff, check:

Would a reader understand the core model without opening the transcript?
Does the prose preserve Jiang's voice and pressure?
Are timestamp ranges useful?
Are refs attached to the claims they support?
Are quoted readings distinguished from Jiang's interpretation?
Are questions real source questions?
Does this read meet or improve on the best existing episode reads?
Did a corpus comparison reveal a missing signature moment or likely lens link?

Then run:

node ops/scripts/compile-content.mjs
node ops/scripts/validate-content.mjs
cd website && npm run build

If available, run:

node ops/scripts/audit-episode-heat.mjs --source-slug <source-slug> --strict --min 3