[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BZCF2W4DD5HZ78MNNPXGCM":3,"skill-same:01M7BZCF2W4DD5HZ78MNNPXGCM":46},{"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":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7BZCF2W4DD5HZ78MNNPXGCM","ds-principles",null,"Compact engineering principles for design, debugging, verification, and delegation, each with a trigger. Use when choosing structure or types, sizing a diff, debugging, writing tests, or when the user types \u002Fds-principles.","Mostafa-Taher-git\u002FGreeneek","Mostafa-Taher-git","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F178865212?v=4","01M7BZ9VH4JJ0HP475H6CEJCGJ","Mostafa Taher Ahmed","01M7BZ9VHSXZMWJSX2W9MSCMB2",0,"MIT","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fds-principles\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ds-principles\ndescription: \"Compact engineering principles for design, debugging, verification, and delegation, each with a trigger. Use when choosing structure or types, sizing a diff, debugging, writing tests, or when the user types \u002Fds-principles.\"\n---\n\n\n# Engineering principles\n\nIf a trigger matches, apply the rule. Name principles that changed a decision.\n\n## Design\n\n1. **Subtract, then add little.** Remove dead code and stale checks first, then make the shortest diff that works. No abstraction with one user. Apply when sizing a diff or tempted to add a layer.\n2. **Data shape first.** Choose the core types and structures before logic. Apply before writing new logic.\n3. **Model the domain.** Put states in one structure, such as a typed union, state machine, or lookup table, not scattered conditionals. Apply when code branches a lot or repeats a shape across files.\n4. **Redesign for the new need.** Fit a new requirement as if it existed from day one. Apply when an addition strains the design.\n5. **Low reader load.** Inline one-caller wrappers and shrink mutable scope. Apply when code is hard to trace.\n6. **Guards at boundaries.** Validate where input enters: CLI, config, network, files, external APIs. Trust types inside and keep core logic pure. Apply when adding validation or error handling.\n7. **Idempotent steps.** Rerunning a step, even after a crash, reaches the same state. Apply to commands, setup, and retries.\n8. **No shared writers.** Give each concurrent actor its own file, branch, or key before using locks. Apply when parallel work touches shared state.\n9. **Migrate, then delete.** Move every caller and delete the old API in one change. No shims. Apply when replacing an API or rewriting in phases.\n10. **Compare options.** For an unprecedented design, sketch two or three. Prefer fewer, polished features. Apply to novel architecture, UX, or scope choices.\n\n## Debugging and verification\n\n11. **Fix root causes.** Fix where state first went wrong. A guard fixes only legitimate states. Apply when debugging.\n12. **Attack the premise.** After two failed fixes that share an assumption, write it down and test it directly. Apply before a third attempt.\n13. **Prove it works.** Run the real thing and read the actual output, not a proxy. Apply before claiming done.\n14. **Verifiable units.** Split work into steps that each end in a passing check. Apply to sweeps, migrations, and stacked commits.\n15. **Test behavior.** Assert what callers can observe, so tests survive refactors. Apply when writing or keeping a test.\n16. **Explain the number.** Find what limits a measurement and confirm it measured the right work. Apply to benchmarks and eval scores.\n17. **Build the tool.** Script bulk or repeated work so it can be rerun. Apply to large edit sets or checks.\n\n## Process\n\n18. **Guard the context.** Keep summaries, not dumps. Send bulk reading to subagents. Apply when outputs or files are large.\n19. **Do not block on the human.** On reversible work, proceed and show the result. Apply when tempted to ask \"should I?\".\n20. **Encode repeated lessons.** A correction given twice becomes a lint, test, or script. Apply when a mistake recurs.\n21. **Comments explain why.** Keep a comment only for a reason the code cannot show, such as an external constraint or a public API contract. Delete narration and dead code. Fix code whose surprise needs a comment. Apply when writing or reviewing code.\n\n## Types\n\n- Make illegal states unrepresentable. Use discriminated unions, not optional-field bags.\n- Parse external data once at the boundary into a named type. Trust it inside.\n- Use `unknown` for untrusted input. Never `any`. No `as` casts before validation.\n- Derive types from a schema, not hand-written guards.\n- Add a `never` check in default branches so new variants fail the build.\n- Brand primitives that must not mix, such as user IDs and order IDs.\n\n## Greeneek working contract\n\nThis skill is installed in the Greeneek repository. Where a step below conflicts with these rules, these rules win.\n\n- Restate the goal in one line, read the real files before editing, and work on `main` in small vertical slices. Preserve uncommitted and concurrent work; never reset, force-push, or overwrite another session's changes.\n- Evidence before \"done\": run the real check and record the exact command and its output. Never weaken a test, add a blind retry, raise a timeout without a diagnosed cause, or delete a failing assertion to get green.\n- Agent waves never commit, push, tag, or publish. No npm auto-publish on `main`; release tags are immutable and Item 8 stays last.\n- Live model lanes stay BLOCKED without `GREENEEK_API_KEY`; mocked coverage is never reported as real-CLI verification.\n- Registrations are effects, ESM everywhere, and misconfiguration fails at the earliest resolvable point.\n- Source of truth: `.agents\u002Fnotes\u002Fproposed\u002Fprocess\u002F2026-11-01-v0.3.9-master-release-plan.md`. Append evidence to its Execution ledger and keep its Resume State current in the same commit as the change.\n\n## Greeneek-specific override\n\nIn this repo also name the Greeneek principle that changed the decision: registrations are effects; ESM everywhere; fail loud at the earliest resolvable point; no pre-release compatibility shims; a registry's `register()` returns the disposer; publish an invariant only when independent observations can diverge.\n","# Engineering principles\n\nIf a trigger matches, apply the rule. Name principles that changed a decision.\n\n## Design\n\n1. **Subtract, then add little.** Remove dead code and stale checks first, then make the shortest diff that works. No abstraction with one user. Apply when sizing a diff or tempted to add a layer.\n2. **Data shape first.** Choose the core types and structures before logic. Apply before writing new logic.\n3. **Model the domain.** Put states in one structure, such as a typed union, state machine, or lookup table, not scattered conditionals. Apply when code branches a lot or repeats a shape across files.\n4. **Redesign for the new need.** Fit a new requirement as if it existed from day one. Apply when an addition strains the design.\n5. **Low reader load.** Inline one-caller wrappers and shrink mutable scope. Apply when code is hard to trace.\n6. **Guards at boundaries.** Validate where input enters: CLI, config, network, files, external APIs. Trust types inside and keep core logic pure. Apply when adding validation or error handling.\n7. **Idempotent steps.** Rerunning a step, even after a crash, reaches the same state. Apply to commands, setup, and retries.\n8. **No shared writers.** Give each concurrent actor its own file, branch, or key before using locks. Apply when parallel work touches shared state.\n9. **Migrate, then delete.** Move every caller and delete the old API in one change. No shims. Apply when replacing an API or rewriting in phases.\n10. **Compare options.** For an unprecedented design, sketch two or three. Prefer fewer, polished features. Apply to novel architecture, UX, or scope choices.\n\n## Debugging and verification\n\n11. **Fix root causes.** Fix where state first went wrong. A guard fixes only legitimate states. Apply when debugging.\n12. **Attack the premise.** After two failed fixes that share an assumption, write it down and test it directly. Apply before a third attempt.\n13. **Prove it works.** Run the real thing and read the actual output, not a proxy. Apply before claiming done.\n14. **Verifiable units.** Split work into steps that each end in a passing check. Apply to sweeps, migrations, and stacked commits.\n15. **Test behavior.** Assert what callers can observe, so tests survive refactors. Apply when writing or keeping a test.\n16. **Explain the number.** Find what limits a measurement and confirm it measured the right work. Apply to benchmarks and eval scores.\n17. **Build the tool.** Script bulk or repeated work so it can be rerun. Apply to large edit sets or checks.\n\n## Process\n\n18. **Guard the context.** Keep summaries, not dumps. Send bulk reading to subagents. Apply when outputs or files are large.\n19. **Do not block on the human.** On reversible work, proceed and show the result. Apply when tempted to ask \"should I?\".\n20. **Encode repeated lessons.** A correction given twice becomes a lint, test, or script. Apply when a mistake recurs.\n21. **Comments explain why.** Keep a comment only for a reason the code cannot show, such as an external constraint or a public API contract. Delete narration and dead code. Fix code whose surprise needs a comment. Apply when writing or reviewing code.\n\n## Types\n\n- Make illegal states unrepresentable. Use discriminated unions, not optional-field bags.\n- Parse external data once at the boundary into a named type. Trust it inside.\n- Use `unknown` for untrusted input. Never `any`. No `as` casts before validation.\n- Derive types from a schema, not hand-written guards.\n- Add a `never` check in default branches so new variants fail the build.\n- Brand primitives that must not mix, such as user IDs and order IDs.\n\n## Greeneek working contract\n\nThis skill is installed in the Greeneek repository. Where a step below conflicts with these rules, these rules win.\n\n- Restate the goal in one line, read the real files before editing, and work on `main` in small vertical slices. Preserve uncommitted and concurrent work; never reset, force-push, or overwrite another session's changes.\n- Evidence before \"done\": run the real check and record the exact command and its output. Never weaken a test, add a blind retry, raise a timeout without a diagnosed cause, or delete a failing assertion to get green.\n- Agent waves never commit, push, tag, or publish. No npm auto-publish on `main`; release tags are immutable and Item 8 stays last.\n- Live model lanes stay BLOCKED without `GREENEEK_API_KEY`; mocked coverage is never reported as real-CLI verification.\n- Registrations are effects, ESM everywhere, and misconfiguration fails at the earliest resolvable point.\n- Source of truth: `.agents\u002Fnotes\u002Fproposed\u002Fprocess\u002F2026-11-01-v0.3.9-master-release-plan.md`. Append evidence to its Execution ledger and keep its Resume State current in the same commit as the change.\n\n## Greeneek-specific override\n\nIn this repo also name the Greeneek principle that changed the decision: registrations are effects; ESM everywhere; fail loud at the earliest resolvable point; no pre-release compatibility shims; a registry's `register()` returns the disposer; publish an invariant only when independent observations can diverge.\n",{"name":5,"description":7},"main","183a0e26a183c692b6f1fc3d97039183e80c4796",".agents\u002Fskills\u002Fds-principles","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek","https:\u002F\u002Fgreeneek.vercel.app\u002F","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git","www.mostafa-taher.duckdns.org","2026-11-15 04:10:26",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Mostafa-Taher-git\u002FGreeneek --skill ds-principles",{"tool":38,"command":39},"bunx","bunx skills add Mostafa-Taher-git\u002FGreeneek --skill ds-principles",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Mostafa-Taher-git\u002FGreeneek --skill ds-principles","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fds-principles\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7BZFPXJY0FHK7MWC9TFFJ6X","user-only-skill","Prove model-disabled skills stay outside the model catalog.","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fsnapshots\u002Fsession\u002Fskill-load\u002Fworkspace\u002F.gnk\u002Fskills\u002Fuser-only-skill\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7BZFM9WBCZKC1QHKJNXCGE2","snapshot-skill","Exercise project skill discovery and loading in snapshot tests.","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fsnapshots\u002Fsession\u002Fskill-load\u002Fworkspace\u002F.gnk\u002Fskills\u002Fsnapshot-skill\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7BZFK35HJX56MKCBR55BW5A","model-only-skill","Prove user-disabled skills remain available to the model.","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fsnapshots\u002Fsession\u002Fskill-load\u002Fworkspace\u002F.gnk\u002Fskills\u002Fmodel-only-skill\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7BZFFRD3339VT24M97Q52ZE","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\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fpackages\u002Fpreset\u002Fagent-presets\u002Fpresets\u002Fcordis\u002Fskills\u002Fediting-cordis-compositions\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7BZFAQMT5FNWTPZ9X8JB1RW","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\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fpackages\u002Fpreset\u002Fagent-presets\u002Fpresets\u002Fcordis\u002Fskills\u002Fcordis-plugin-development\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7BZF8Q58ZZ1T0Y08SVHK9XM","preview-tour","Inspect the bundled Preview workspace and its deterministic Session examples.","https:\u002F\u002Fgithub.com\u002FMostafa-Taher-git\u002FGreeneek\u002Fblob\u002Fmain\u002Fpackages\u002Fexperimental\u002Fwebworker-runtime\u002Ftests\u002Ffixtures\u002Fvfs-example\u002Fworkspace\u002F.agents\u002Fskills\u002Fpreview-tour\u002FSKILL.md",[],[]]