[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ERW7M6YNJMATJZ2J6FFV1G":3,"skill-same:01M7ERW7M6YNJMATJZ2J6FFV1G":48},{"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":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ERW7M6YNJMATJZ2J6FFV1G","forge-reference",null,"Distill one library into a pack reference for the version this repo locks: its idioms as the repo uses them, pitfalls and version notes, every claim cited to official docs or file:line. Use when a pack skill needs library facts, or corrections show the agent misusing a library.","Ventorius\u002Fven-stack","Ventorius","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5689509?v=4","01M7ERRDPQ5YXCNXJZWEKQNP50","Sebastian Basznianin","01M7ERRDQ9S0ZD9YMH1RN1WVP7",0,"MIT","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fforge-reference\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: forge-reference\ndescription: \"Distill one library into a pack reference for the version this repo locks: its idioms as the repo uses them, pitfalls and version notes, every claim cited to official docs or file:line. Use when a pack skill needs library facts, or corrections show the agent misusing a library.\"\nmetadata:\n  layer: L3\n  source: cursor\u002Fplugins@1e5c90a:pstack\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md + EveryInc\u002Fcompound-engineering-plugin@7a68002:skills\u002Fce-plan\u002Freferences\u002Fagents\u002Fframework-docs-researcher.md + mattpocock\u002Fskills@49dd158:skills\u002Fengineering\u002Fresearch\u002FSKILL.md\n  license: MIT\n---\n\n# Forge a reference\n\nA reference holds the library facts a pack skill reads on demand: short, pinned to the locked version, and cited claim by claim. Skills hold judgment; references hold facts.\n\n**Input:** a library and the pack. `\u003Cpack dir>` is `$(ven-profile path)\u002Fpacks\u002F\u003Cpack>\u002F`.\n\n## 1. Pin the version\n\nRead the resolved version from the lockfiles the profile lists (`ven-profile get stack.sources`). No lockfile entry for the library: stop and say so. An unpinned reference goes stale without anyone noticing.\n\n## 2. Gather, in parallel\n\n**delegate** two read-only worker briefs. They gather; you synthesize.\n\n- **Docs:** fetch the official documentation for the locked version with your agent's web fetch tool: the docs pages for the APIs the repo calls, the changelog or release notes, and the migration guide from the version most examples assume. Check deprecations first. Primary sources only: the library's own docs, repository and changelog. Return claims, each with its URL.\n- **Usages:** search the repo for the library's imports and calls. Return each distinct usage pattern with a count and up to three `file:line` examples, and every usage that contradicts the docs.\n\n## 3. Distill\n\nWrite `\u003Cpack dir>\u002Freferences\u002F\u003Clibrary>.md` in this shape:\n\n```markdown\n# \u003Clibrary> \u003Cversion>\n\nLocked in \u003Clockfile>. Docs fetched \u003Cdate>.\n\n## Idioms\n| Idiom | How this repo does it | Seen at |\n\n## Pitfalls\n| Pitfall | Symptom | Do instead | Source |\n\n## Version notes\n- \u003Cwhat differs in this version from what most examples assume: new, deprecated, removed> (\u003Csource>)\n\n## Sources\n- \u003Curl>\n```\n\n- Every row cites a docs URL or `file:line`. A claim with no source is cut.\n- Keep what changes the agent's behavior in this repo. A generic tutorial is noise the agent already knows.\n- Where the repo contradicts the docs, record it as a pitfall and flag it to the user; deciding which side is right is theirs.\n- One library per file, under 150 lines.\n\n## 4. Check the citations\n\nApply **citation-check**: each `file:line` says what its row claims, and each URL contains its claim. Fix or cut every row that fails.\n\n## 5. Register\n\n1. Add `{ \"file\": \"references\u002F\u003Clibrary>.md\", \"library\", \"version\", \"lockfile\" }` to `references` in `\u003Cpack dir>\u002Fpack.json`. Pack audits compare that version with the lockfile to find stale references.\n2. In each pack skill that needs the facts, fill the \"Library facts\" line that ven's skill template (`$(ven-profile root)\u002Fsetup\u002Fassets\u002Ftemplates\u002Fskill\u002FSKILL.md`) provides: when to read the reference, in one line.\n3. Bump the patch `version` in `\u003Cpack dir>\u002Fpack.json`.\n","# Forge a reference\n\nA reference holds the library facts a pack skill reads on demand: short, pinned to the locked version, and cited claim by claim. Skills hold judgment; references hold facts.\n\n**Input:** a library and the pack. `\u003Cpack dir>` is `$(ven-profile path)\u002Fpacks\u002F\u003Cpack>\u002F`.\n\n## 1. Pin the version\n\nRead the resolved version from the lockfiles the profile lists (`ven-profile get stack.sources`). No lockfile entry for the library: stop and say so. An unpinned reference goes stale without anyone noticing.\n\n## 2. Gather, in parallel\n\n**delegate** two read-only worker briefs. They gather; you synthesize.\n\n- **Docs:** fetch the official documentation for the locked version with your agent's web fetch tool: the docs pages for the APIs the repo calls, the changelog or release notes, and the migration guide from the version most examples assume. Check deprecations first. Primary sources only: the library's own docs, repository and changelog. Return claims, each with its URL.\n- **Usages:** search the repo for the library's imports and calls. Return each distinct usage pattern with a count and up to three `file:line` examples, and every usage that contradicts the docs.\n\n## 3. Distill\n\nWrite `\u003Cpack dir>\u002Freferences\u002F\u003Clibrary>.md` in this shape:\n\n```markdown\n# \u003Clibrary> \u003Cversion>\n\nLocked in \u003Clockfile>. Docs fetched \u003Cdate>.\n\n## Idioms\n| Idiom | How this repo does it | Seen at |\n\n## Pitfalls\n| Pitfall | Symptom | Do instead | Source |\n\n## Version notes\n- \u003Cwhat differs in this version from what most examples assume: new, deprecated, removed> (\u003Csource>)\n\n## Sources\n- \u003Curl>\n```\n\n- Every row cites a docs URL or `file:line`. A claim with no source is cut.\n- Keep what changes the agent's behavior in this repo. A generic tutorial is noise the agent already knows.\n- Where the repo contradicts the docs, record it as a pitfall and flag it to the user; deciding which side is right is theirs.\n- One library per file, under 150 lines.\n\n## 4. Check the citations\n\nApply **citation-check**: each `file:line` says what its row claims, and each URL contains its claim. Fix or cut every row that fails.\n\n## 5. Register\n\n1. Add `{ \"file\": \"references\u002F\u003Clibrary>.md\", \"library\", \"version\", \"lockfile\" }` to `references` in `\u003Cpack dir>\u002Fpack.json`. Pack audits compare that version with the lockfile to find stale references.\n2. In each pack skill that needs the facts, fill the \"Library facts\" line that ven's skill template (`$(ven-profile root)\u002Fsetup\u002Fassets\u002Ftemplates\u002Fskill\u002FSKILL.md`) provides: when to read the reference, in one line.\n3. Bump the patch `version` in `\u003Cpack dir>\u002Fpack.json`.\n",{"name":5,"metadata":24,"description":7},{"layer":25,"source":26,"license":15},"L3","cursor\u002Fplugins@1e5c90a:pstack\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md + EveryInc\u002Fcompound-engineering-plugin@7a68002:skills\u002Fce-plan\u002Freferences\u002Fagents\u002Fframework-docs-researcher.md + mattpocock\u002Fskills@49dd158:skills\u002Fengineering\u002Fresearch\u002FSKILL.md","main","e57e3dd5c8aec0fe40658397aee9fd9b1d77bb60","plugins\u002Fven\u002Fskills\u002Fforge-reference","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack","https:\u002F\u002Fgithub.com\u002FVentorius","Heavy testing believer. Workflow automation fan. Fullstack JS developer.","2026-11-04 04:05:46",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Ventorius\u002Fven-stack --skill forge-reference",{"tool":40,"command":41},"bunx","bunx skills add Ventorius\u002Fven-stack --skill forge-reference",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Ventorius\u002Fven-stack --skill forge-reference","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fforge-reference\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7ES1P06ZPAGTT7YS4V6MS32","yeet","Take every local change green through the repo's own checks, slice it into conventional commits, push, and with --pr open a pull request on the code host. Use only when the user explicitly asks to yeet, or to commit and push everything; never on your own initiative.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7ES1JHVQEN3YYMRZEBM2E79","write-docs","Write or update documentation from the code: gather facts, pick the shape for the reader, write it plain, and prove every command and path in it. Use when asked to document a repo, module or feature, or to bring stale docs up to date.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fwrite-docs\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7ES1DD3YVMF1MY7D51R6516","why","Find why code is shaped the way it is (design rationale, trade-offs, regressions, odd thresholds) from history, tickets, docs and chat, citing every claim and stating its confidence. Use for 'why does X work this way', 'why did we pick Y', or before changing code whose purpose is unclear.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7ES18XVRZGQ0V1BBZH63Q8W","verify","Prove a change works with the check that matches its type, do the read-back, and log the pass against the exact tree. Use when a change is ready to call done, before review, commit or stopping, and whenever ven-decisions end refuses an unverified tree.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Fverify\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7ES15Z3W8QTJH4CRAJ53D2G","unslop","Cut AI writing tells (filler, model vocabulary, metaphor nouns, hedging, formatting tics) from text while keeping every fact. Use when editing or checking any prose before it ships: docs, PR bodies, reports, skill text.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7ES12GT9WD9NE2X3M1B29ZZ","type-discipline","Apply when designing types or data shapes, reviewing a signature, or handling outside data, in any language. Make wrong states fail early: in the compiler for typed languages, in validated runtime contracts for untyped ones.","https:\u002F\u002Fgithub.com\u002FVentorius\u002Fven-stack\u002Fblob\u002Fmain\u002Fplugins\u002Fven\u002Fskills\u002Ftype-discipline\u002FSKILL.md",[],[]]