[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APFPAA4DAS5JD7Y9G1Q29E":3,"skill-same:01M7APFPAA4DAS5JD7Y9G1Q29E":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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7APFPAA4DAS5JD7Y9G1Q29E","seekdeep-native-plugin",null,"Use when adding, porting, or extending a SeekDeep Harness plugin as a Rust crate under crates\u002F — a model-facing tool, a service provider or consumer, an LLM adapter, a persistence, sandbox, or OS integration, or any built-in the seekdeep binary ships — and whenever new harness behavior needs a home and the choice between a native Rust crate and a TypeScript file plugin is still open; covers the crate skeleton, Plugin::new with config validation, typed services and reversible effects, catalog and bundle registration, composition and oracle tests, README pairs, generated catalogs, the parity manifest, and the Rust gates.","trevorprater\u002Fseekdeep-harness","trevorprater","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1281520?v=4","01M7APEBFEFSTN909Q7WJ3RG2S","Trevor Prater","01M7APEBGJNX3RYPY8Y8H6P2W7",5,"MIT","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fseekdeep-native-plugin\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: seekdeep-native-plugin\ndescription: Use when adding, porting, or extending a SeekDeep Harness plugin as a Rust crate under crates\u002F — a model-facing tool, a service provider or consumer, an LLM adapter, a persistence, sandbox, or OS integration, or any built-in the seekdeep binary ships — and whenever new harness behavior needs a home and the choice between a native Rust crate and a TypeScript file plugin is still open; covers the crate skeleton, Plugin::new with config validation, typed services and reversible effects, catalog and bundle registration, composition and oracle tests, README pairs, generated catalogs, the parity manifest, and the Rust gates.\n---\n\n# SeekDeep Native Plugin\n\nGuide an agent through adding or changing a plugin crate so the result matches the crates the port already ships. This is guidance, not a script: the contracts live in the documents below, and this skill only orders the work and names the evidence each step needs.\n\n## Read the contracts\n\n- [crates\u002FAGENTS.md](..\u002F..\u002F..\u002Fcrates\u002FAGENTS.md) — the crate shape, wiring, tests, and gates.\n- [packages\u002FAGENTS.md](..\u002F..\u002F..\u002Fpackages\u002FAGENTS.md) — the behavioral rules every plugin obeys regardless of language.\n- Root [AGENTS.md](..\u002F..\u002F..\u002FAGENTS.md) — parity, naming, and Rust conventions.\n- [Where new behavior goes](..\u002F..\u002F..\u002Fdocs\u002Farchitecture.md#where-new-behavior-goes) — which service or event a capability attaches to.\n- [Runtime placement](..\u002F..\u002F..\u002Fporting\u002FDYNAMIC_PLUGIN_RELOAD.md#runtime-placement) — what stays native and what stays JavaScript.\n\n## Decide the runtime first\n\nWrite Rust when the plugin is part of the product: anything the `seekdeep` binary ships, anything on the hot path or touching filesystem, subprocess, sandbox, persistence, or OS integration, anything with a typed cross-plugin contract, and anything the parity, determinism, or invariant machinery must verify. A native crate is compiled into the binary and registered at boot; there is no dynamic native loading.\n\nWrite a TypeScript file plugin when the plugin arrives at runtime: a path in `cordis.yml` that must load without a rebuild, hot reload on save, or an out-of-tree extension. Model-authored `cordis_define` packages are JavaScript by contract. Keep those surfaces intact; they are preserved source behavior, not legacy ([your first plugin](..\u002F..\u002F..\u002Fdocs\u002Fuser\u002Fdevelop\u002Fbasic\u002Findex.md)).\n\nDuring the port, a capability absent from the pinned source is post-parity work; port and preserve first ([POST_PARITY](..\u002F..\u002F..\u002Fporting\u002FPOST_PARITY.md)).\n\n## Workflow\n\n1. Name the seam. Pick the service or event the capability attaches to from the architecture table; a new capability needs its Service Definition, provider, and consumer roles, and its name follows the [naming rules](..\u002F..\u002F..\u002Fdocs\u002Fcookbook\u002Fadding-a-package.md#name-the-role-that-exists).\n2. Start from a shipped crate of the same role rather than from scratch: `crates\u002Ftool-todo` for a tool, `crates\u002Fcordis-timer` for a service provider, `crates\u002Fcordis\u002Fexamples\u002Fhello_cordis.rs` for the lifecycle in isolation. Copy the shape, then replace the behavior.\n3. Implement `NAME`, `INJECT`, `plugin()`, the config `Schema` and its validator, and an `apply` whose every registration is an effect the fiber unwinds. Prove disposal in a test that disposes the fiber and observes removal.\n4. Wire it: the boot roster in `apps\u002Fseekdeep\u002Fsrc\u002Fprofile_boot.rs` under both names, the bundle row with its config, and the package manifest and README pair beside the crate README.\n5. Test it: `tests\u002Floader_composition.rs` through the real Loader, unit tests for the behavior, oracle tests only for a ported surface, and snapshot tests for model-visible text.\n6. Regenerate and record: the catalogs the change touches, the `porting\u002Fparity.json` entry for a ported surface, and an Agent Note for any decision a maintainer may revisit.\n7. Verify with `cargo fmt --all -- --check`, `cargo clippy --workspace --all-targets --all-features -- -D warnings`, `cargo test -p seekdeep-\u003Cname> --all-features`, the catalog `--check` runs, and `verify-cordis-config`; then select the rest through [seekdeep-pre-push-checks](..\u002Fseekdeep-pre-push-checks\u002FSKILL.md).\n\n## Traps\n\n- A `packages\u002F\u003Cgroup>\u002F\u003Cpkg>\u002Fsrc\u002Findex.ts` is not where runtime lands; the TypeScript cookbook describes the manifest and README half of a plugin.\n- `context.get` on an injected service inside the body is guaranteed to succeed; `get_relaxed` exists for observers that must see a provider while it is still loading.\n- Config that names an unavailable provider or resource fails at the earliest resolvable point, in the validator or the first line of `apply`, never later.\n- Crates in the determinism perimeter never call `Instant::now()` or `SystemTime::now()`; take a clock through a seam.\n- The oracle tests need the checkout named in `SOURCE_SNAPSHOT`; a container without it fails those binaries, which says nothing about your change.\n\n## Report\n\nState which seam the plugin attaches to, the roster and bundle rows added, the composition and unit tests, the catalogs regenerated, and every gate run with its result. Name any deviation from the pinned source and where it is recorded.\n","# SeekDeep Native Plugin\n\nGuide an agent through adding or changing a plugin crate so the result matches the crates the port already ships. This is guidance, not a script: the contracts live in the documents below, and this skill only orders the work and names the evidence each step needs.\n\n## Read the contracts\n\n- [crates\u002FAGENTS.md](..\u002F..\u002F..\u002Fcrates\u002FAGENTS.md) — the crate shape, wiring, tests, and gates.\n- [packages\u002FAGENTS.md](..\u002F..\u002F..\u002Fpackages\u002FAGENTS.md) — the behavioral rules every plugin obeys regardless of language.\n- Root [AGENTS.md](..\u002F..\u002F..\u002FAGENTS.md) — parity, naming, and Rust conventions.\n- [Where new behavior goes](..\u002F..\u002F..\u002Fdocs\u002Farchitecture.md#where-new-behavior-goes) — which service or event a capability attaches to.\n- [Runtime placement](..\u002F..\u002F..\u002Fporting\u002FDYNAMIC_PLUGIN_RELOAD.md#runtime-placement) — what stays native and what stays JavaScript.\n\n## Decide the runtime first\n\nWrite Rust when the plugin is part of the product: anything the `seekdeep` binary ships, anything on the hot path or touching filesystem, subprocess, sandbox, persistence, or OS integration, anything with a typed cross-plugin contract, and anything the parity, determinism, or invariant machinery must verify. A native crate is compiled into the binary and registered at boot; there is no dynamic native loading.\n\nWrite a TypeScript file plugin when the plugin arrives at runtime: a path in `cordis.yml` that must load without a rebuild, hot reload on save, or an out-of-tree extension. Model-authored `cordis_define` packages are JavaScript by contract. Keep those surfaces intact; they are preserved source behavior, not legacy ([your first plugin](..\u002F..\u002F..\u002Fdocs\u002Fuser\u002Fdevelop\u002Fbasic\u002Findex.md)).\n\nDuring the port, a capability absent from the pinned source is post-parity work; port and preserve first ([POST_PARITY](..\u002F..\u002F..\u002Fporting\u002FPOST_PARITY.md)).\n\n## Workflow\n\n1. Name the seam. Pick the service or event the capability attaches to from the architecture table; a new capability needs its Service Definition, provider, and consumer roles, and its name follows the [naming rules](..\u002F..\u002F..\u002Fdocs\u002Fcookbook\u002Fadding-a-package.md#name-the-role-that-exists).\n2. Start from a shipped crate of the same role rather than from scratch: `crates\u002Ftool-todo` for a tool, `crates\u002Fcordis-timer` for a service provider, `crates\u002Fcordis\u002Fexamples\u002Fhello_cordis.rs` for the lifecycle in isolation. Copy the shape, then replace the behavior.\n3. Implement `NAME`, `INJECT`, `plugin()`, the config `Schema` and its validator, and an `apply` whose every registration is an effect the fiber unwinds. Prove disposal in a test that disposes the fiber and observes removal.\n4. Wire it: the boot roster in `apps\u002Fseekdeep\u002Fsrc\u002Fprofile_boot.rs` under both names, the bundle row with its config, and the package manifest and README pair beside the crate README.\n5. Test it: `tests\u002Floader_composition.rs` through the real Loader, unit tests for the behavior, oracle tests only for a ported surface, and snapshot tests for model-visible text.\n6. Regenerate and record: the catalogs the change touches, the `porting\u002Fparity.json` entry for a ported surface, and an Agent Note for any decision a maintainer may revisit.\n7. Verify with `cargo fmt --all -- --check`, `cargo clippy --workspace --all-targets --all-features -- -D warnings`, `cargo test -p seekdeep-\u003Cname> --all-features`, the catalog `--check` runs, and `verify-cordis-config`; then select the rest through [seekdeep-pre-push-checks](..\u002Fseekdeep-pre-push-checks\u002FSKILL.md).\n\n## Traps\n\n- A `packages\u002F\u003Cgroup>\u002F\u003Cpkg>\u002Fsrc\u002Findex.ts` is not where runtime lands; the TypeScript cookbook describes the manifest and README half of a plugin.\n- `context.get` on an injected service inside the body is guaranteed to succeed; `get_relaxed` exists for observers that must see a provider while it is still loading.\n- Config that names an unavailable provider or resource fails at the earliest resolvable point, in the validator or the first line of `apply`, never later.\n- Crates in the determinism perimeter never call `Instant::now()` or `SystemTime::now()`; take a clock through a seam.\n- The oracle tests need the checkout named in `SOURCE_SNAPSHOT`; a container without it fails those binaries, which says nothing about your change.\n\n## Report\n\nState which seam the plugin attaches to, the roster and bundle rows added, the composition and unit tests, the catalogs regenerated, and every gate run with its result. Name any deviation from the pinned source and where it is recorded.\n",{"name":5,"description":7},"main","6f09f012cb7c0443b1bf3098cb3c90fd03055961",".agents\u002Fskills\u002Fseekdeep-native-plugin",0,"https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness","https:\u002F\u002Fgithub.com\u002Ftrevorprater","https:\u002F\u002Ffugue-labs.ai","2026-11-11 04:06:22",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add trevorprater\u002Fseekdeep-harness --skill seekdeep-native-plugin",{"tool":38,"command":39},"bunx","bunx skills add trevorprater\u002Fseekdeep-harness --skill seekdeep-native-plugin",{"tool":41,"command":42},"pnpm","pnpm dlx skills add trevorprater\u002Fseekdeep-harness --skill seekdeep-native-plugin","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fseekdeep-native-plugin\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",232,"https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fseekdeep-native-plugin\u002Fagents\u002Fopenai.yaml",[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},"01M7APH34EMDPY6P76Z6HH1X11","user-only-skill","Prove model-disabled skills stay outside the model catalog.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002Fexamples\u002Facp-agent\u002Ftests\u002Fsnapshots\u002Fskill-load\u002Fworkspace\u002F.seekdeep\u002Fskills\u002Fuser-only-skill\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},"01M7APH1M04P7XFJS1HN611T7P","snapshot-skill","Exercise project skill discovery and loading in snapshot tests.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002Fexamples\u002Facp-agent\u002Ftests\u002Fsnapshots\u002Fskill-load\u002Fworkspace\u002F.seekdeep\u002Fskills\u002Fsnapshot-skill\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},"01M7APH05DY23TCV2WG85Y849P","model-only-skill","Prove user-disabled skills remain available to the model.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002Fexamples\u002Facp-agent\u002Ftests\u002Fsnapshots\u002Fskill-load\u002Fworkspace\u002F.seekdeep\u002Fskills\u002Fmodel-only-skill\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},"01M7APGVSJT0J3V6FQBQCFK7H6","editing-cordis-compositions","Use when creating, changing, or validating a Cordis composition for this harness — writing or editing an agent preset, adding or removing a plugin row, deciding whether something belongs to the host composition or to one session, checking whether a preset you authored actually mounts, or diagnosing a row that mounted but contributed nothing.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002Fapps\u002Fcli\u002Fconfig\u002Fagent-presets\u002Fcordis\u002Fskills\u002Fediting-cordis-compositions\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},"01M7APGNDK68YM21S6C8D8F3PS","cordis-plugin-development","Create, modify, debug, or extend dynamic Cordis Plugins, including Host Services and Events, Client Slot and theme UI, Package-private Client-to-Host calls, dynamic Tools, version updates, approval failures, and runtime diagnostics. Use this Skill to route a user request to the correct platform and Inspect Provider, then define, run, repair, or roll back the Plugin.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002Fapps\u002Fcli\u002Fconfig\u002Fagent-presets\u002Fcordis\u002Fskills\u002Fcordis-plugin-development\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},"01M7APGEK8CT4YZH6XXJ2Q57ET","seekdeep-trim-cot-leakage","Use when auditing or fixing prose that reads like a leaked reasoning transcript — dead design-session citations such as (decision N), audit item codes, or §N of uncommitted drafts; change narration such as \"used to\", \"no longer\", \"this cut\"; stack or review vantage (\"a later PR in this stack\", \"rejected in review\"); reviewer-addressed justifications; control-flow narration; or hedged planning residue in comments, JSDoc, docs, or Agent Notes.","https:\u002F\u002Fgithub.com\u002Ftrevorprater\u002Fseekdeep-harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fseekdeep-trim-cot-leakage\u002FSKILL.md",[],[]]