[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7353PP0ND9SYF1JCE7524PR":3,"skill-same:01M7353PP0ND9SYF1JCE7524PR":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":31,"commitSha":32,"skillDirectory":33,"forksCount":34,"repositoryHtmlUrl":35,"repositoryHomepageUrl":36,"ownerHtmlUrl":37,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":38,"install":39,"resources":51},"01M7353PP0ND9SYF1JCE7524PR","fix-forward-references",null,"Fix forward references in text.","Morrison-Lab\u002Fai-config","Morrison-Lab","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F104235520?v=4","01M734G0451S2G35MN4HFQK7XP","Morrison Lab","01M734G059BYFDFQA8YTPDGPMH",4,"MIT","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Ffix-forward-references\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: fix-forward-references\ndescription: \"Fix forward references in text.\"\nuser-invocable: true\nallowed-tools:\n  - Bash\n  - Read\n  - Grep\n  - Edit\n  - Write\n---\n\n# fix-forward-references — detect and rearrange to remove forward pointers\n\nA forward reference makes a reader hold an unresolved pointer: \"as\ndiscussed below\" promises content they haven't seen yet. This skill finds\nthose, confirms they're real (not an idiom, not already fixed), and fixes\nthem by moving content earlier or, when reordering isn't the right call,\nrewording the pointer into a working link.\n\nThe full detection heuristic, confirmation checklist, and fix menu live in\n[`shared\u002Fwriting\u002Fforward-references.md`](..\u002F..\u002Fshared\u002Fwriting\u002Fforward-references.md) —\nread it before running this skill; the steps below are the short version.\n\n## When this fires\n\n- \"fix forward references\", \"find forward references\", \"check for forward\n  references\", \"remove forward references\", \"fix-forward-references\", \"ffr\"\n- \"this points ahead to something not written yet\", \"rearrange this so\n  nothing references content below it\"\n- **As part of any PR\u002FMR review that touches narrative prose** (docs,\n  READMEs, papers, PR\u002Fissue descriptions) — run alongside\n  `definition-crossrefs.md`'s formal-crossref-div check, `fact-check-prose`,\n  and `find-ai-tells`.\n\n## Procedure\n\n1. **Identify the target.** A file, a PR\u002FMR diff, or pasted prose.\n2. **Grep for candidates** using the heuristic in\n   [`forward-references.md`](..\u002F..\u002Fshared\u002Fwriting\u002Fforward-references.md#the-detection-heuristic) ---\n   start with the bare directional word (below, later, following,\n   subsequently, further down, next, afterward); use the narrower\n   reference-cue-paired pattern as a higher-confidence secondary filter\n   when the primary grep returns too many idiom hits:\n   ```bash\n   # Primary grep: directional words\n   rg -ni '\\b(below|later|following|subsequently|further down|next|afterward)\\b' \u003Cfile>\n\n   # Narrower secondary filter: cue paired with directional word\n   rg -ni '(@[a-z0-9_-]+|section|figure|table|chapter)[^.]{0,60}\\b(below|later|following|subsequently|further down|next|afterward)\\b' \u003Cfile>\n   rg -ni '\\b(below|later|following|subsequently|further down|next|afterward)\\b[^.]{0,60}(@[a-z0-9_-]+|section|figure|table|chapter)' \u003Cfile>\n\n   # Numbered procedural pointers (e.g. in sequential steps)\n   rg -ni '\\b(per|see|as in|described in|from) (step|item|point) [0-9]+' \u003Cfile>\n   ```\n3. **Confirm each hit.** Read the sentence: is it a genuine reference (not\n   an idiom like \"below average\"), and does the target really come after\n   the mention (not already earlier, just mis-worded)? Drop anything that\n   fails either check.\n4. **Fix each confirmed forward reference**, in order of preference:\n   - **Reorder** --- move the referenced section\u002Fparagraph\u002Fdiv\u002Ffigure\u002Ftable\n     earlier so it precedes the mention. Update the directional word\n     (\"below\" → \"above\") or drop it once a working crossref link carries\n     the point.\n   - **Reword** --- only when reordering would break the document's\n     narrative logic. Replace the vague pointer with a precise, working\n     link\u002Fcrossref instead of leaving a bare \"below\".\n     For any `@`-crossref (`@def-`, `@sec-`, `@fig-`, `@tbl-`, `@thm-`,\n     `@eq-`, ...), keep the link and signpost it\n     (\"one-versus-one, defined later in this section\n     (@def-one-versus-one)\");\n     never delete the link and leave only the bare name.\n     The exception: you may leave out the pointer when the passage\n     motivates the definition that follows\n     (see the fragment's \"Keep the crossref\").\n   - **Leave it** when the mention is a deliberate roadmap\u002Foverview preview\n     (see the fragment's \"roadmap exception\") --- not every forward-pointing\n     sentence is a defect.\n5. **Re-scan** the touched section after editing to confirm no new forward\n   reference was introduced by the reordering itself (e.g., a paragraph\n   that used to follow the moved content and referenced it backward now\n   needs the opposite fix).\n6. **Report.** For each finding: the phrase, its location, whether it was\n   fixed by reordering or rewording (or left, with why), and the diff.\n\n## Relationship to other skills\n\n- **`shared\u002Fwriting\u002Fdefinition-crossrefs.md`** (cited from `CLAUDE.md`'s\n  \"Hyperlink technical terms and results\" section, not a standalone skill)\n  --- the narrower, formal-crossref-div case of this same problem, scoped\n  to term\u002Ftheorem definitions. Its check works by comparing div position to\n  first mention directly, so it catches a bare `@def-x` crossref with no\n  directional word at all --- something this skill's grep heuristic misses.\n  Run both on a diff that touches definitions.\n- **`detect-informal-definitions`** --- a concept with no formal\n  definition div of its own can't be crossref'd, which is exactly what\n  pushes an author toward a forward-pointing phrase in the first place.\n  Run it alongside this skill on a diff that introduces new technical\n  content; fixing its findings often removes a forward reference for free.\n- **`check-rendered-refs` \u002F `crr`** --- checks whether a crossref *resolved*\n  at render time; this skill checks whether it points in the right\n  *direction*, on the source prose, before render.\n- **`challenge-ambiguous-terminology.md`** --- catches unclear terms; this\n  skill assumes the term is clear and checks whether the reader has already\n  been given whatever it's pointing at.\n- **`find-ai-tells` \u002F `fact-check-prose`** --- sibling prose-review passes;\n  run all three together on a diff that touches narrative prose.\n- **`ard` \u002F `ardi`** --- when reviewing a PR\u002FMR, apply this check alongside\n  the other prose-review rules `CLAUDE.md` lists.\n\n## Anti-patterns\n\n- ❌ Flagging every \"below\"\u002F\"later\" as a forward reference --- most idiomatic\n  uses (\"values below zero\") aren't references at all; read the sentence\n  before flagging.\n- ❌ Reordering content without re-scanning afterward --- a move can turn a\n  previously-fine backward reference into a new forward one.\n- ❌ Treating a deliberate roadmap\u002Foverview paragraph as a defect --- see the\n  fragment's roadmap exception.\n- ❌ Rewording as the default fix --- reordering is the stronger fix\n  (removes the pointer entirely); reserve rewording for when reordering\n  would break the narrative.\n- ❌ Deleting a forward `@`-crossref and leaving the bare name ---\n  that is worse than the forward reference; keep the link and signpost it.\n","# fix-forward-references — detect and rearrange to remove forward pointers\n\nA forward reference makes a reader hold an unresolved pointer: \"as\ndiscussed below\" promises content they haven't seen yet. This skill finds\nthose, confirms they're real (not an idiom, not already fixed), and fixes\nthem by moving content earlier or, when reordering isn't the right call,\nrewording the pointer into a working link.\n\nThe full detection heuristic, confirmation checklist, and fix menu live in\n[`shared\u002Fwriting\u002Fforward-references.md`](..\u002F..\u002Fshared\u002Fwriting\u002Fforward-references.md) —\nread it before running this skill; the steps below are the short version.\n\n## When this fires\n\n- \"fix forward references\", \"find forward references\", \"check for forward\n  references\", \"remove forward references\", \"fix-forward-references\", \"ffr\"\n- \"this points ahead to something not written yet\", \"rearrange this so\n  nothing references content below it\"\n- **As part of any PR\u002FMR review that touches narrative prose** (docs,\n  READMEs, papers, PR\u002Fissue descriptions) — run alongside\n  `definition-crossrefs.md`'s formal-crossref-div check, `fact-check-prose`,\n  and `find-ai-tells`.\n\n## Procedure\n\n1. **Identify the target.** A file, a PR\u002FMR diff, or pasted prose.\n2. **Grep for candidates** using the heuristic in\n   [`forward-references.md`](..\u002F..\u002Fshared\u002Fwriting\u002Fforward-references.md#the-detection-heuristic) ---\n   start with the bare directional word (below, later, following,\n   subsequently, further down, next, afterward); use the narrower\n   reference-cue-paired pattern as a higher-confidence secondary filter\n   when the primary grep returns too many idiom hits:\n   ```bash\n   # Primary grep: directional words\n   rg -ni '\\b(below|later|following|subsequently|further down|next|afterward)\\b' \u003Cfile>\n\n   # Narrower secondary filter: cue paired with directional word\n   rg -ni '(@[a-z0-9_-]+|section|figure|table|chapter)[^.]{0,60}\\b(below|later|following|subsequently|further down|next|afterward)\\b' \u003Cfile>\n   rg -ni '\\b(below|later|following|subsequently|further down|next|afterward)\\b[^.]{0,60}(@[a-z0-9_-]+|section|figure|table|chapter)' \u003Cfile>\n\n   # Numbered procedural pointers (e.g. in sequential steps)\n   rg -ni '\\b(per|see|as in|described in|from) (step|item|point) [0-9]+' \u003Cfile>\n   ```\n3. **Confirm each hit.** Read the sentence: is it a genuine reference (not\n   an idiom like \"below average\"), and does the target really come after\n   the mention (not already earlier, just mis-worded)? Drop anything that\n   fails either check.\n4. **Fix each confirmed forward reference**, in order of preference:\n   - **Reorder** --- move the referenced section\u002Fparagraph\u002Fdiv\u002Ffigure\u002Ftable\n     earlier so it precedes the mention. Update the directional word\n     (\"below\" → \"above\") or drop it once a working crossref link carries\n     the point.\n   - **Reword** --- only when reordering would break the document's\n     narrative logic. Replace the vague pointer with a precise, working\n     link\u002Fcrossref instead of leaving a bare \"below\".\n     For any `@`-crossref (`@def-`, `@sec-`, `@fig-`, `@tbl-`, `@thm-`,\n     `@eq-`, ...), keep the link and signpost it\n     (\"one-versus-one, defined later in this section\n     (@def-one-versus-one)\");\n     never delete the link and leave only the bare name.\n     The exception: you may leave out the pointer when the passage\n     motivates the definition that follows\n     (see the fragment's \"Keep the crossref\").\n   - **Leave it** when the mention is a deliberate roadmap\u002Foverview preview\n     (see the fragment's \"roadmap exception\") --- not every forward-pointing\n     sentence is a defect.\n5. **Re-scan** the touched section after editing to confirm no new forward\n   reference was introduced by the reordering itself (e.g., a paragraph\n   that used to follow the moved content and referenced it backward now\n   needs the opposite fix).\n6. **Report.** For each finding: the phrase, its location, whether it was\n   fixed by reordering or rewording (or left, with why), and the diff.\n\n## Relationship to other skills\n\n- **`shared\u002Fwriting\u002Fdefinition-crossrefs.md`** (cited from `CLAUDE.md`'s\n  \"Hyperlink technical terms and results\" section, not a standalone skill)\n  --- the narrower, formal-crossref-div case of this same problem, scoped\n  to term\u002Ftheorem definitions. Its check works by comparing div position to\n  first mention directly, so it catches a bare `@def-x` crossref with no\n  directional word at all --- something this skill's grep heuristic misses.\n  Run both on a diff that touches definitions.\n- **`detect-informal-definitions`** --- a concept with no formal\n  definition div of its own can't be crossref'd, which is exactly what\n  pushes an author toward a forward-pointing phrase in the first place.\n  Run it alongside this skill on a diff that introduces new technical\n  content; fixing its findings often removes a forward reference for free.\n- **`check-rendered-refs` \u002F `crr`** --- checks whether a crossref *resolved*\n  at render time; this skill checks whether it points in the right\n  *direction*, on the source prose, before render.\n- **`challenge-ambiguous-terminology.md`** --- catches unclear terms; this\n  skill assumes the term is clear and checks whether the reader has already\n  been given whatever it's pointing at.\n- **`find-ai-tells` \u002F `fact-check-prose`** --- sibling prose-review passes;\n  run all three together on a diff that touches narrative prose.\n- **`ard` \u002F `ardi`** --- when reviewing a PR\u002FMR, apply this check alongside\n  the other prose-review rules `CLAUDE.md` lists.\n\n## Anti-patterns\n\n- ❌ Flagging every \"below\"\u002F\"later\" as a forward reference --- most idiomatic\n  uses (\"values below zero\") aren't references at all; read the sentence\n  before flagging.\n- ❌ Reordering content without re-scanning afterward --- a move can turn a\n  previously-fine backward reference into a new forward one.\n- ❌ Treating a deliberate roadmap\u002Foverview paragraph as a defect --- see the\n  fragment's roadmap exception.\n- ❌ Rewording as the default fix --- reordering is the stronger fix\n  (removes the pointer entirely); reserve rewording for when reordering\n  would break the narrative.\n- ❌ Deleting a forward `@`-crossref and leaving the bare name ---\n  that is worse than the forward reference; keep the link and signpost it.\n",{"name":5,"description":7,"allowed-tools":24,"user-invocable":30},[25,26,27,28,29],"Bash","Read","Grep","Edit","Write",true,"main","0f720481f8ce3b3d9fef485f6e230d8b3035748e","skills\u002Ffix-forward-references",1,"https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config","https:\u002F\u002Fmorrison-lab.github.io\u002Fai-config\u002F","https:\u002F\u002Fgithub.com\u002FMorrison-Lab","2026-11-15 04:39:15",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":30},[41,44,47],{"tool":42,"command":43},"npx","npx skills add Morrison-Lab\u002Fai-config --skill fix-forward-references",{"tool":45,"command":46},"bunx","bunx skills add Morrison-Lab\u002Fai-config --skill fix-forward-references",{"tool":48,"command":49},"pnpm","pnpm dlx skills add Morrison-Lab\u002Fai-config --skill fix-forward-references","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Ffix-forward-references\u002FSKILL.md",[],[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M735BVYCGR5VEC65AFDVSNKW","wrap-up","End-of-session verification and UMS.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fwrap-up\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M735BTH469T1CQ8G2Q9GENCR","workaround-watcher","Watch upstream issue for fix.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fworkaround-watcher\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M735BRKZWFANSQ0GM380B4TD","wn","→ whats-next.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fwn\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M735BPE9V830B3B6NGXQ56J6","whats-next","Recommend concrete next step or action.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fwhats-next\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M735BMHQ60EAD5B7QAWXC5A0","wait-for-results","Wait for pipeline\u002FCI results.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fwait-for-results\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M735BKGZHPN1PEMJ7YBD5VJ8","wai","→ send-notes.","https:\u002F\u002Fgithub.com\u002FMorrison-Lab\u002Fai-config\u002Fblob\u002Fmain\u002Fskills\u002Fwai\u002FSKILL.md",[],[]]