Portfolio Material
Collection only: material in, material/<id>/ items out. Not for writing the portfolio, rendering a deck, or feedback loop-back (later steps).
Script, run from the project root: node ${CLAUDE_PLUGIN_ROOT}/skills/material/scripts/material.mjs <subcommand> [flags]. Each prints one JSON object. In a manage workspace (a root with sources/) the items folder is sources/material/; a root that already has material/ keeps it.
| Subcommand |
Flags |
Does |
id |
--source --title |
Returns the slug id |
match |
--id --source --title |
new / same / ambiguous (+ candidates); writes nothing |
init |
--id --source --title (opt. --period --role --tags) |
Creates the item folder with the seven parts, status raw; exists writes nothing |
index |
none |
Rewrites material/index.md only if its content changes |
log |
--id --note (opt. --add-source) |
Appends a line to history.md; a note already there is unchanged. --add-source records a merged second source in meta.md (also:) so it matches same next time |
gaps |
none |
Open and answered question counts per item, from gaps.md |
answer |
--id --question --citation |
Marks the open gaps.md question [답변됨] with the citation of the answering material; the line stays |
foreign |
none |
Lists files in material/ the flow did not write |
ledger |
none |
A workspace that keeps material as sources/NN_프로젝트/A1….md: lists each graded file (A, B, C + n) as item NN_프로젝트/A1 with grade, title, header (first line > 등급 · 프로젝트 · 원자료: <path>) and whether it is written; excluded = the X_ files; analysis = whether the analysis/ link exists; problems = other grade letters, no header, not in the project README, no X_ file, no README, not in the project table. Writes nothing |
ledger-scaffold |
opt. --project NN_이름 --period P |
Creates what problems lists as missing, never overwriting: the project README.md (items and grades), X_쓰지않을것.md, the sources/README.md project table (folder, project, period; a missing row is appended) |
ledger-log |
--item --note (opt. --status --later-step) |
Appends one line under ## 이력 at the end of that ledger file, nothing above it touched; a note already there is unchanged |
update |
--item --note --source (opt. --line N or N-M) |
Ledger file: appends ## 갱신 — <date> with the note and 출처: <source>:<line> at the end, nothing above it touched; the same note and source again is unchanged |
item-pages |
none |
Reads portfolio-skeleton.md (old skeleton.md too): item → pages from the 글감: lines; stale = pages whose item text changed since the table kept in sources/item-pages.json (first run: baseline, none stale); missing = cited ids with no item |
--status (on log and init) is reserved for later steps: the script refuses it without --later-step <name>. Step 1 never passes either flag.
Re-run: same needs the same --source and --title as the first run, so keep the source file name and section stable. Copy the source: line of the item's meta.md and its title; a changed file name or section gives ambiguous, not same.
Per-part procedures: references/parts.md. Citation, evidence and matching: references/citation-evidence-matching.md.
Rules
- (a) Only the given material is used; nothing is invented. Every filled part holds a short paraphrase plus a verbatim quote or pointer, cited
<file> + heading or line range (a line range only when the text has no heading; with a heading, cite heading plus quote and no line numbers, which go stale when lines are added above); for pasted or chat text, a message index, timestamp or verbatim first-words quote.
- (b) Anything unknown goes to
gaps.md as a question for the user and is never guessed.
- (c) In
result.md, a figure with a unit or percentage needs an evidence citation; a figure the user flags as their own claim ("체감상", "내 기억으로는", "I estimate", or says so when handing over) is labelled user-stated; a figure with no citation in the handed material and no such flag is marked 근거 없음 and gets a gaps.md question for its source. A figure written plainly in the text, with no record and no flag, is the 근거 없음 case, even when the user wrote the whole text: user-stated needs words about the figure itself ("체감상", "I estimate"), never just authorship. A figure citing a document that was not handed over is also 근거 없음, its question naming that document. 근거 없음 is the only missing-evidence marker.
- (d) On a re-run,
match decides: same updates the parts in place and logs it in history.md; new runs init; ambiguous asks the user to pick merge or new, never a guess. An answer to a gaps question arrives as new material: the part is updated with its citation and answer marks the question [답변됨]. An answered question is never deleted.
- (e) Step 1 creates status
raw and never changes status. Later steps own every other transition and name themselves with --later-step; each is logged in history.md.
- (f) Content stays in the language of the material. Personal or confidential data is kept as given and stored only in the user's project.
- (g) Foreign files in
material/ are left alone and listed in the summary.
- (h) The final summary lists items added or updated, the open gaps count taken from
gaps (never counted by hand), and the foreign files.
- (i) A no-op run writes nothing, history.md included: when the handed material adds nothing to an item, edit no part, skip
log and answer, and leave index.md as it is. Never rewrite an existing citation to fix drift or wording; a citation changes only when its line changes.
Process
- Read every handed file or pasted text in full. Split it into episodes (one problem → decision → result story each). No episode found → say so and stop.
- Identify each episode:
id from source and title, then match.
- Branch on the result (rule d). Stop on
ambiguous for that episode and ask; continue with the others.
- Fill the seven parts per
references/parts.md: init for new; for same, read the item's parts and compare the episode statement by statement, then add each statement the parts lack in place, cited. Apply rules (a)-(c) line by line. Write parts with the file tools (Write/Edit), never shell echo or heredocs: citations hold quotes and #, which break shell quoting. Re-read each file you wrote and check no line ends mid-citation. For each answered gaps question, answer it after the part is updated, with --question set to the open line exactly as it stands after - , [part] prefix included.
- Record:
log one note per item created or changed (source, what changed); skip it for an item that did not change (rule i). Never pass --status.
- Index and scan: run
index, then foreign.
- Summarize per the template.
Ledger shape (ledger workspace)
Trigger: "글감 원장 정리해줘". One item = one file <grade><n>_<title>.md in sources/<NN>_<project>/. A stands as its own page, B is a bullet or evidence for another item, C is a footnote only. Each file opens with > 등급 · 프로젝트 · 원자료: <path>.
ledger; say each problems entry. Wrong grade letters and missing headers are the user's to fix (ask which grade); do not rename or rewrite their files.
ledger-scaffold for missing READMEs, X_쓰지않을것.md and project rows; ask the period for a new project.
- Raw material is read from the
analysis/ link (a read-only archive): read it, never write there; cite it as the 원자료: path.
X_ files list topics not to use and why (interview attack risk): never made into items, never cited by portfolio:manage claims; a new such topic is appended to the project's X_ file with its reason, from the user's words.
Refresh from notes (ledger workspace)
Trigger: the user asks to pull analysis or notes into the ledger. Not a collection run.
- Read only the note files the user points to, in full. Ask for the path if none is given; never search the disk for notes.
ledger, then match each note statement to an item. A statement fitting no item or several: ask, do not guess. A figure with no unit evidence stays as the user's note says it, with its source.
update --item --note --source [--line] once per statement (short paraphrase, rule a). Then ledger-log one line per item changed.
item-pages, and print stale as <item> → <pages> for portfolio:manage to revisit; missing ids and a baseline run are said as such.
Output Template
수집 결과 (<n>건 입력 → 추가 <a>, 갱신 <u>, 질문 대기 <q>)
- 추가: <id> — <title>
- 갱신: <id> — <what changed> (출처: <citation>)
- 병합/신규 선택 대기: <id> ↔ <candidate id> — <reason>
열린 빈칸: <count> (<id>: <question> ...)
foreign 파일: <paths or 없음>
다음 단계(이 skill 범위 밖): 글쓰기, 덱 렌더링, 피드백 반영
What Claude Does / What You Do
| Claude |
You |
Splits the material into episodes, runs match, fills parts with cited paraphrases |
Hand over the material; keep file names and sections stable between runs |
| Marks unsourced figures and writes unknowns as gaps.md questions |
Answer gaps by handing the answer as new material |
Asks merge or new on ambiguous |
Pick merge or new |
| Reports items, open gaps and foreign files |
Move or remove foreign files yourself if you want them gone |
Related Skills
- Neighbour:
portfolio:job-application-workflow (the full application flow this feeds)
- Later steps, not done here: writing, deck rendering (
portfolio:deck-builder), feedback loop-back
1---2name: material3description: >-4 Use when career material (retrospectives, notes, chat dumps) is handed over5 to collect as portfolio items, or the ledger must refresh from notes.6 Triggers: "글감 모아줘", "글감 원장 정리해줘", "분석 당겨와", "노트에서 갱신", "글감 업데이트",7 "refresh my material from notes".8scenarios:9 - "Here is my retrospective. Collect the episodes as portfolio material."10 - "I added one detail to the payment-migration story and answered your question — update it."11 - "Turn these notes and chat logs into material items, don't make anything up."12 - "이 회고록에서 글감 모아줘"13 - "내가 준 자료로 에피소드별 글감 폴더 만들어줘"14 - "지난번 질문에 답했어, 글감 업데이트해줘"15 - "노트에서 분석 당겨와서 글감 갱신해줘"16 - "Refresh my material from these notes and tell me which pages went stale."17compatibility:18 optional:19 - think-tool20 remote_mcp_note: >-21 MCP 없이도 동작합니다. think-tool은 에피소드 경계나 병합 여부가 애매할 때만 쓰입니다.22metadata:23 source: https://skillmd.com/skills/newkayak12/material24---2526# Portfolio Material2728Collection only: material in, `material/<id>/` items out. **Not for** writing the portfolio, rendering a deck, or feedback loop-back (later steps).2930Script, run from the project root: `node ${CLAUDE_PLUGIN_ROOT}/skills/material/scripts/material.mjs <subcommand> [flags]`. Each prints one JSON object. In a `manage` workspace (a root with `sources/`) the items folder is `sources/material/`; a root that already has `material/` keeps it.3132| Subcommand | Flags | Does |33|---|---|---|34| `id` | `--source --title` | Returns the slug id |35| `match` | `--id --source --title` | `new` / `same` / `ambiguous` (+ candidates); writes nothing |36| `init` | `--id --source --title` (opt. `--period --role --tags`) | Creates the item folder with the seven parts, status `raw`; `exists` writes nothing |37| `index` | none | Rewrites `material/index.md` only if its content changes |38| `log` | `--id --note` (opt. `--add-source`) | Appends a line to `history.md`; a note already there is `unchanged`. `--add-source` records a merged second source in `meta.md` (`also:`) so it matches `same` next time |39| `gaps` | none | Open and answered question counts per item, from `gaps.md` |40| `answer` | `--id --question --citation` | Marks the open gaps.md question `[답변됨]` with the citation of the answering material; the line stays |41| `foreign` | none | Lists files in `material/` the flow did not write |42| `ledger` | none | A workspace that keeps material as `sources/NN_프로젝트/A1….md`: lists each graded file (A, B, C + n) as item `NN_프로젝트/A1` with grade, title, `header` (first line `> 등급 · 프로젝트 · 원자료: <path>`) and whether it is `written`; `excluded` = the `X_` files; `analysis` = whether the `analysis/` link exists; `problems` = other grade letters, no header, not in the project README, no `X_` file, no README, not in the project table. Writes nothing |43| `ledger-scaffold` | opt. `--project NN_이름 --period P` | Creates what `problems` lists as missing, never overwriting: the project `README.md` (items and grades), `X_쓰지않을것.md`, the `sources/README.md` project table (folder, project, period; a missing row is appended) |44| `ledger-log` | `--item --note` (opt. `--status --later-step`) | Appends one line under `## 이력` at the end of that ledger file, nothing above it touched; a note already there is `unchanged` |45| `update` | `--item --note --source` (opt. `--line N` or `N-M`) | Ledger file: appends `## 갱신 — <date>` with the note and `출처: <source>:<line>` at the end, nothing above it touched; the same note and source again is `unchanged` |46| `item-pages` | none | Reads `portfolio-skeleton.md` (old `skeleton.md` too): item → pages from the `글감:` lines; `stale` = pages whose item text changed since the table kept in `sources/item-pages.json` (first run: baseline, none stale); `missing` = cited ids with no item |4748`--status` (on `log` and `init`) is reserved for later steps: the script refuses it without `--later-step <name>`. Step 1 never passes either flag.4950Re-run: `same` needs the same `--source` and `--title` as the first run, so keep the source file name and section stable. Copy the `source:` line of the item's `meta.md` and its title; a changed file name or section gives `ambiguous`, not `same`.51Per-part procedures: `references/parts.md`. Citation, evidence and matching: `references/citation-evidence-matching.md`.5253## Rules5455- (a) Only the given material is used; nothing is invented. Every filled part holds a short paraphrase plus a verbatim quote or pointer, cited `<file> + heading or line range` (a line range only when the text has no heading; with a heading, cite heading plus quote and no line numbers, which go stale when lines are added above); for pasted or chat text, a message index, timestamp or verbatim first-words quote.56- (b) Anything unknown goes to `gaps.md` as a question for the user and is never guessed.57- (c) In `result.md`, a figure with a unit or percentage needs an evidence citation; a figure the user flags as their own claim ("체감상", "내 기억으로는", "I estimate", or says so when handing over) is labelled `user-stated`; a figure with no citation in the handed material and no such flag is marked `근거 없음` and gets a gaps.md question for its source. A figure written plainly in the text, with no record and no flag, is the `근거 없음` case, even when the user wrote the whole text: `user-stated` needs words about the figure itself ("체감상", "I estimate"), never just authorship. A figure citing a document that was not handed over is also `근거 없음`, its question naming that document. `근거 없음` is the only missing-evidence marker.58- (d) On a re-run, `match` decides: `same` updates the parts in place and logs it in `history.md`; `new` runs `init`; `ambiguous` asks the user to pick merge or new, never a guess. An answer to a gaps question arrives as new material: the part is updated with its citation and `answer` marks the question `[답변됨]`. An answered question is never deleted.59- (e) Step 1 creates status `raw` and never changes status. Later steps own every other transition and name themselves with `--later-step`; each is logged in `history.md`.60- (f) Content stays in the language of the material. Personal or confidential data is kept as given and stored only in the user's project.61- (g) Foreign files in `material/` are left alone and listed in the summary.62- (h) The final summary lists items added or updated, the open gaps count taken from `gaps` (never counted by hand), and the foreign files.63- (i) A no-op run writes nothing, history.md included: when the handed material adds nothing to an item, edit no part, skip `log` and `answer`, and leave `index.md` as it is. Never rewrite an existing citation to fix drift or wording; a citation changes only when its line changes.6465## Process66671. **Read** every handed file or pasted text in full. Split it into episodes (one problem → decision → result story each). No episode found → say so and stop.682. **Identify** each episode: `id` from source and title, then `match`.693. **Branch** on the result (rule d). Stop on `ambiguous` for that episode and ask; continue with the others.704. **Fill** the seven parts per `references/parts.md`: `init` for `new`; for `same`, read the item's parts and compare the episode statement by statement, then add each statement the parts lack in place, cited. Apply rules (a)-(c) line by line. Write parts with the file tools (Write/Edit), never shell `echo` or heredocs: citations hold quotes and `#`, which break shell quoting. Re-read each file you wrote and check no line ends mid-citation. For each answered gaps question, `answer` it after the part is updated, with `--question` set to the open line exactly as it stands after `- `, `[part]` prefix included.715. **Record**: `log` one note per item created or changed (source, what changed); skip it for an item that did not change (rule i). Never pass `--status`.726. **Index and scan**: run `index`, then `foreign`.737. **Summarize** per the template.7475### Ledger shape (ledger workspace)7677Trigger: "글감 원장 정리해줘". One item = one file `<grade><n>_<title>.md` in `sources/<NN>_<project>/`. A stands as its own page, B is a bullet or evidence for another item, C is a footnote only. Each file opens with `> 등급 · 프로젝트 · 원자료: <path>`.78791. `ledger`; say each `problems` entry. Wrong grade letters and missing headers are the user's to fix (ask which grade); do not rename or rewrite their files.802. `ledger-scaffold` for missing READMEs, `X_쓰지않을것.md` and project rows; ask the period for a new project.813. Raw material is read from the `analysis/` link (a read-only archive): read it, never write there; cite it as the `원자료:` path.824. `X_` files list topics not to use and why (interview attack risk): never made into items, never cited by `portfolio:manage` `claims`; a new such topic is appended to the project's `X_` file with its reason, from the user's words.8384### Refresh from notes (ledger workspace)8586Trigger: the user asks to pull analysis or notes into the ledger. Not a collection run.87881. Read only the note files the user points to, in full. Ask for the path if none is given; never search the disk for notes.892. `ledger`, then match each note statement to an item. A statement fitting no item or several: ask, do not guess. A figure with no unit evidence stays as the user's note says it, with its source.903. `update --item --note --source [--line]` once per statement (short paraphrase, rule a). Then `ledger-log` one line per item changed.914. `item-pages`, and print `stale` as `<item> → <pages>` for `portfolio:manage` to revisit; `missing` ids and a baseline run are said as such.9293## Output Template9495```96수집 결과 (<n>건 입력 → 추가 <a>, 갱신 <u>, 질문 대기 <q>)97- 추가: <id> — <title>98- 갱신: <id> — <what changed> (출처: <citation>)99- 병합/신규 선택 대기: <id> ↔ <candidate id> — <reason>100열린 빈칸: <count> (<id>: <question> ...)101foreign 파일: <paths or 없음>102다음 단계(이 skill 범위 밖): 글쓰기, 덱 렌더링, 피드백 반영103```104105## What Claude Does / What You Do106107| Claude | You |108|--------|-----|109| Splits the material into episodes, runs `match`, fills parts with cited paraphrases | Hand over the material; keep file names and sections stable between runs |110| Marks unsourced figures and writes unknowns as gaps.md questions | Answer gaps by handing the answer as new material |111| Asks merge or new on `ambiguous` | Pick merge or new |112| Reports items, open gaps and foreign files | Move or remove foreign files yourself if you want them gone |113114## Related Skills115116- Neighbour: `portfolio:job-application-workflow` (the full application flow this feeds)117- Later steps, not done here: writing, deck rendering (`portfolio:deck-builder`), feedback loop-back