[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B3F197YVYDX0C86ASNHYFB":3,"skill-same:01M7B3F197YVYDX0C86ASNHYFB":45},{"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":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7B3F197YVYDX0C86ASNHYFB","vvkit-writing-project-instructions",null,"Use when creating or editing an AGENTS.md or legacy CLAUDE.md, when it has grown long, or when a rule in it also exists in an installed skill.","vadimvitvickiy\u002Fvv-agent-kit","vadimvitvickiy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5019512?v=4","01M7B3ABRYF7KHBCDW6GB2XH0C","Vadim Vitvitskii","01M7B3ABSZYG9MXP1CC7BQYM25",0,"MIT","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fcodex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-writing-project-instructions\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vvkit-writing-project-instructions\ndescription: \"Use when creating or editing an AGENTS.md or legacy CLAUDE.md, when it has grown long, or when a rule in it also exists in an installed skill.\"\n---\n\n# Writing project instructions\n\n**AGENTS.md is loaded as project guidance; a skill's body costs nothing until it fires.**\nPast a couple of hundred lines adherence drops, and the rule that mattered competes with forty that\ndid not apply.\n\n## Codex runtime\n\nLoad referenced skills by reading their SKILL.md. Surveyor, reviewer and runner\nskills are role instructions, not registered agent types or enforced tool allowlists.\nUse a generic subagent only when delegation is available and permitted; otherwise\nperform the role inline. Follow the active session's model, context and permission\nrules. User authorization takes precedence over imported workflow approval gates.\nClaude hooks and plugin commands are not active in this package. Existing\n`.claude\u002Fcontext\u002F` paths refer to project documents, not Codex configuration.\n\n## What goes where\n\n| Content | Home |\n|-|-|\n| Facts only this repo knows — how to build, run, test it | AGENTS.md |\n| Constraints invisible in the file being edited — layering rules, generated files, frozen names | AGENTS.md |\n| Standing preferences about how to respond | AGENTS.md |\n| A discipline needed only for a certain kind of work | a skill |\n| A rule that must hold whether or not the model cooperates | a hook |\n| Anything an installed skill already states | a one-line reference, never a copy |\n\nTest for moving something out: **would it still make sense in a different repo?** Then it is a\ndiscipline, paid for on every turn to be relevant on a few.\n\n## Never duplicate an installed skill\n\n- A rule in both places is forked, not reinforced. When the copies drift, the always-on one wins.\n- Replace the copy with a reference:\n\n  ```markdown\n  - **Testing:** `$vvkit-writing-tests` for whether a test is owed, `$vvkit-swift-swift-testing` for how to write one.\n  - **Debugging:** `$vvkit-debugging-systematically` — trace to origin before proposing a fix.\n  ```\n\n- **Before removing a rule, confirm the skill states it.** A rule with no home gets migrated first;\n  deleting it because it \"feels covered\" is how a convention silently stops being followed. A\n  portable rule with no home is a missing skill.\n\n## Keep what is genuinely always-on\n\n- The repo's build, test and lint commands — they save a discovery pass every session.\n- Constraints broken by the very edit that would trigger the skill.\n- Output and tone preferences.\n- Anything a hook depends on the reader knowing.\n\n## Shape\n\n- Short sections with headings, so a reader skips what does not apply.\n- Rules as rules, with the reason where it is not obvious — a reason generalises to the case the rule\n  did not spell out.\n- Plain statements. Emphasis everywhere marks nothing.\n\n`$vvkit-wire` reconciles a AGENTS.md against the installed skills mechanically. Read it before doing\nthe same edit by hand.\n","# Writing project instructions\n\n**AGENTS.md is loaded as project guidance; a skill's body costs nothing until it fires.**\nPast a couple of hundred lines adherence drops, and the rule that mattered competes with forty that\ndid not apply.\n\n## Codex runtime\n\nLoad referenced skills by reading their SKILL.md. Surveyor, reviewer and runner\nskills are role instructions, not registered agent types or enforced tool allowlists.\nUse a generic subagent only when delegation is available and permitted; otherwise\nperform the role inline. Follow the active session's model, context and permission\nrules. User authorization takes precedence over imported workflow approval gates.\nClaude hooks and plugin commands are not active in this package. Existing\n`.claude\u002Fcontext\u002F` paths refer to project documents, not Codex configuration.\n\n## What goes where\n\n| Content | Home |\n|-|-|\n| Facts only this repo knows — how to build, run, test it | AGENTS.md |\n| Constraints invisible in the file being edited — layering rules, generated files, frozen names | AGENTS.md |\n| Standing preferences about how to respond | AGENTS.md |\n| A discipline needed only for a certain kind of work | a skill |\n| A rule that must hold whether or not the model cooperates | a hook |\n| Anything an installed skill already states | a one-line reference, never a copy |\n\nTest for moving something out: **would it still make sense in a different repo?** Then it is a\ndiscipline, paid for on every turn to be relevant on a few.\n\n## Never duplicate an installed skill\n\n- A rule in both places is forked, not reinforced. When the copies drift, the always-on one wins.\n- Replace the copy with a reference:\n\n  ```markdown\n  - **Testing:** `$vvkit-writing-tests` for whether a test is owed, `$vvkit-swift-swift-testing` for how to write one.\n  - **Debugging:** `$vvkit-debugging-systematically` — trace to origin before proposing a fix.\n  ```\n\n- **Before removing a rule, confirm the skill states it.** A rule with no home gets migrated first;\n  deleting it because it \"feels covered\" is how a convention silently stops being followed. A\n  portable rule with no home is a missing skill.\n\n## Keep what is genuinely always-on\n\n- The repo's build, test and lint commands — they save a discovery pass every session.\n- Constraints broken by the very edit that would trigger the skill.\n- Output and tone preferences.\n- Anything a hook depends on the reader knowing.\n\n## Shape\n\n- Short sections with headings, so a reader skips what does not apply.\n- Rules as rules, with the reason where it is not obvious — a reason generalises to the case the rule\n  did not spell out.\n- Plain statements. Emphasis everywhere marks nothing.\n\n`$vvkit-wire` reconciles a AGENTS.md against the installed skills mechanically. Read it before doing\nthe same edit by hand.\n",{"name":5,"description":7},"main","cc22a222a76add5759a2df5fadf231a758691db5","codex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-writing-project-instructions","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy","Senior iOS engineer. Architecture, SDKs and apps for iOS, tvOS and watchOS.","2026-11-13 19:10:29",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-writing-project-instructions",{"tool":37,"command":38},"bunx","bunx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-writing-project-instructions",{"tool":40,"command":41},"pnpm","pnpm dlx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-writing-project-instructions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fcodex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-writing-project-instructions\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7B3JN7VG0YJ4JB8RP6HYZSJ","no-heading","Use when proving that the validator rejects a body with no H1 and a force-loading @-link.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fno-heading\u002FSKILL.md",[],[],{"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},"01M7B3JJMEW4E710ZG6HYJ7BWV","wrong-name-does-not-match-dir","Dispatches a subagent per task and reviews between each one.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fbroken-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},"01M7B3JGE9MFT1HRP41YRVKN97","writing-tests","Use when adding or changing behavior, fixing a bug, or judging whether an existing or generated test earns its place.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-tests\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},"01M7B3JD5X32VEBDBN7HB8E17Z","writing-skills","Use when authoring or editing a skill, agent, command or hook for this kit, or when deciding whether a piece of guidance belongs in a skill at all.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\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},"01M7B3J992MZH2QVZRED0DRPD9","writing-project-instructions","Use when creating or editing a CLAUDE.md or AGENTS.md, when it has grown long, or when a rule in it also exists in an installed skill.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-project-instructions\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},"01M7B3J55C5WPWN20QXP9ET848","writing-logs","Use when adding or reviewing log statements, or when deciding what level a message belongs at.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-logs\u002FSKILL.md",[],[]]