[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DY4FSKT3CAPTK2Q9T27YXE":3,"skill-same:01M6DY4FSKT3CAPTK2Q9T27YXE":98},{"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":16,"sourceHtmlUrl":17,"categories":18,"keywords":32,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":50,"ownerHtmlUrl":51,"ownerBlogUrl":50,"ownerDescription":52,"updatedAt":53,"install":54,"resources":67},"01M6DY4FSKT3CAPTK2Q9T27YXE","writing-for-agents",null,"This skill should be used when creating or editing skills, agent definitions, AGENTS.md, CLAUDE.md, or reference documents intended for agents.","OyadotAI\u002Foya-browser","OyadotAI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F236266305?v=4","01M6DY3AA3S9J5ZRTV037PHZ9P","Oya AI","01M6DY3AEYV4GDJ8J1QCMPVJ7P",349,"MIT","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[19,24,27],{"categoryNo":20,"categoryName":21,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000018","写作与文案","SCENARIO","使用场景",{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":28,"categoryName":29,"taxonomyType":30,"taxonomyTypeDesc":31},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[33,34,35,36,37,38,39],"writing","writing for agents","for","documents","editing","reference","when","2026-11-10 10:12:30",false,"---\nname: writing-for-agents\ndescription: \"This skill should be used when creating or editing skills, agent definitions, AGENTS.md, CLAUDE.md, or reference documents intended for agents.\"\n---\n\n# Write instructions agents can follow\n\nDefine the target behavior, trigger, permitted actions, and completion evidence before adding\ninstructions. Preserve the user's scope and existing authorization. Keep instructions consistent\nwith the host's permissions and the assigned member's tools; a skill cannot grant new authority.\n\n## Put information where it is needed\n\nKeep the primary workflow in the main document. Co-locate each rule with its conditions and\ncaveats. Put specialized branches in supporting references and link them from the decision point\nthat needs them. State both what a reference contains and when to read it. Verify every local\nlink resolves within the shipped bundle.\n\nKeep always-loaded descriptions short and specific. Give one trigger for each distinct branch\nrather than a list of synonyms. Use the project's established vocabulary. Inline an essential\nrule when a pointer would make it easy to miss; keep longer reference material behind a clear\npointer. Split documents only when the split helps a real reader or execution branch.\n\n## Make completion observable\n\nWrite steps as concrete actions with evidence of completion: source locations inspected, inputs\ncovered, artifacts produced, or observations recorded. Define what to do when evidence is\nunavailable. Separate observed results, inferences, and hypotheses. Avoid a requirement to claim\nverification when the role cannot run the relevant check.\n\nState the intended behavior directly. Keep hard prohibitions where they enforce real permission,\ndata, or tool constraints, and provide the permitted path. Resolve routine choices from the\nassignment rather than inserting a new approval gate. Require user input only for material\nunknown decisions or actions outside existing authorization.\n\n## Package skills deliberately\n\nSupply YAML `name` and `description`. Choose model invocation for a workflow the agent needs to\ndiscover on its own. Set `disable-model-invocation: true` for an explicit command that should\nrun only when requested; use a short human-facing description and avoid preloading it into\nunrelated members. Respect the host's supported metadata rather than assuming every platform\nimplements the same frontmatter.\n\nShip only resources referenced by a useful workflow. Preserve attribution and required licenses\nfor adapted material. Keep scripts and tools within the agent's actual permissions. Use Oya\nBrowser exclusively for browser instructions. Inspect available tool schemas instead of inventing\ntool names or parameters.\n\n## Prune and review\n\nKeep each behavioral rule in one authoritative place. Reference discoverable configuration\ninstead of caching commands, ports, or directory lists that can go stale. Retain the non-obvious\nreason and failure mode. Remove duplicated, irrelevant, or ambiguous instructions. Check likely\nrequest examples against the trigger, workflow branches, and completion criteria; label this\nas a static review. Runtime trials require the user's testing authorization.\n\nComplete when an agent can identify when to load the document, what to do, what evidence to\nreturn, and how to handle a blocker with its assigned tools.\n\nAdapted from Matt Pocock's productivity skills; see [SOURCE.md](SOURCE.md) and [LICENSE](LICENSE).\n","# Write instructions agents can follow\n\nDefine the target behavior, trigger, permitted actions, and completion evidence before adding\ninstructions. Preserve the user's scope and existing authorization. Keep instructions consistent\nwith the host's permissions and the assigned member's tools; a skill cannot grant new authority.\n\n## Put information where it is needed\n\nKeep the primary workflow in the main document. Co-locate each rule with its conditions and\ncaveats. Put specialized branches in supporting references and link them from the decision point\nthat needs them. State both what a reference contains and when to read it. Verify every local\nlink resolves within the shipped bundle.\n\nKeep always-loaded descriptions short and specific. Give one trigger for each distinct branch\nrather than a list of synonyms. Use the project's established vocabulary. Inline an essential\nrule when a pointer would make it easy to miss; keep longer reference material behind a clear\npointer. Split documents only when the split helps a real reader or execution branch.\n\n## Make completion observable\n\nWrite steps as concrete actions with evidence of completion: source locations inspected, inputs\ncovered, artifacts produced, or observations recorded. Define what to do when evidence is\nunavailable. Separate observed results, inferences, and hypotheses. Avoid a requirement to claim\nverification when the role cannot run the relevant check.\n\nState the intended behavior directly. Keep hard prohibitions where they enforce real permission,\ndata, or tool constraints, and provide the permitted path. Resolve routine choices from the\nassignment rather than inserting a new approval gate. Require user input only for material\nunknown decisions or actions outside existing authorization.\n\n## Package skills deliberately\n\nSupply YAML `name` and `description`. Choose model invocation for a workflow the agent needs to\ndiscover on its own. Set `disable-model-invocation: true` for an explicit command that should\nrun only when requested; use a short human-facing description and avoid preloading it into\nunrelated members. Respect the host's supported metadata rather than assuming every platform\nimplements the same frontmatter.\n\nShip only resources referenced by a useful workflow. Preserve attribution and required licenses\nfor adapted material. Keep scripts and tools within the agent's actual permissions. Use Oya\nBrowser exclusively for browser instructions. Inspect available tool schemas instead of inventing\ntool names or parameters.\n\n## Prune and review\n\nKeep each behavioral rule in one authoritative place. Reference discoverable configuration\ninstead of caching commands, ports, or directory lists that can go stale. Retain the non-obvious\nreason and failure mode. Remove duplicated, irrelevant, or ambiguous instructions. Check likely\nrequest examples against the trigger, workflow branches, and completion criteria; label this\nas a static review. Runtime trials require the user's testing authorization.\n\nComplete when an agent can identify when to load the document, what to do, what evidence to\nreturn, and how to handle a blocker with its assigned tools.\n\nAdapted from Matt Pocock's productivity skills; see [SOURCE.md](SOURCE.md) and [LICENSE](LICENSE).\n",{"name":5,"description":7},"main","8f05c557ae3d6a2d7ece88c6762a78eca078c740",".agents\u002Fskills\u002Fwriting-for-agents",274,"https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser","https:\u002F\u002Foyabrowser.com","https:\u002F\u002Fgithub.com\u002FOyadotAI","The browser built for AI agents. Sign in once, do the task once, and Oya replays it forever with no model in the loop.","2026-11-14 01:05:11",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add OyadotAI\u002Foya-browser --skill writing-for-agents",{"tool":60,"command":61},"bunx","bunx skills add OyadotAI\u002Foya-browser --skill writing-for-agents",{"tool":63,"command":64},"pnpm","pnpm dlx skills add OyadotAI\u002Foya-browser --skill writing-for-agents","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",true,[68,72,78,82,86,90,94],{"path":69,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":16},"LICENSE","许可证",1068,{"path":73,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fanalysis-modules.md","REFERENCE","参考文档",6270,"https:\u002F\u002Fgithub.com\u002Fgjbvsjjvgm-sketch\u002Fhermes-sovereign-unified-v13.6\u002Fblob\u002Fmain\u002Fhermes-agent\u002Fskills\u002Fmlops\u002Finference\u002Fobliteratus\u002Freferences\u002Fanalysis-modules.md",{"path":79,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fmethods-guide.md",6719,"https:\u002F\u002Fgithub.com\u002Fgjbvsjjvgm-sketch\u002Fhermes-sovereign-unified-v13.6\u002Fblob\u002Fmain\u002Fhermes-agent\u002Fskills\u002Fmlops\u002Finference\u002Fobliteratus\u002Freferences\u002Fmethods-guide.md",{"path":83,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":84,"sourceHtmlUrl":85},"SOURCE.md",870,"https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002FSOURCE.md",{"path":87,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":88,"sourceHtmlUrl":89},"templates\u002Fabliteration-config.yaml",1189,"https:\u002F\u002Fgithub.com\u002Fgjbvsjjvgm-sketch\u002Fhermes-sovereign-unified-v13.6\u002Fblob\u002Fmain\u002Fhermes-agent\u002Fskills\u002Fmlops\u002Finference\u002Fobliteratus\u002Ftemplates\u002Fabliteration-config.yaml",{"path":91,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":92,"sourceHtmlUrl":93},"templates\u002Fanalysis-study.yaml",1368,"https:\u002F\u002Fgithub.com\u002Fgjbvsjjvgm-sketch\u002Fhermes-sovereign-unified-v13.6\u002Fblob\u002Fmain\u002Fhermes-agent\u002Fskills\u002Fmlops\u002Finference\u002Fobliteratus\u002Ftemplates\u002Fanalysis-study.yaml",{"path":95,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":96,"sourceHtmlUrl":97},"templates\u002Fbatch-abliteration.yaml",1201,"https:\u002F\u002Fgithub.com\u002Fgjbvsjjvgm-sketch\u002Fhermes-sovereign-unified-v13.6\u002Fblob\u002Fmain\u002Fhermes-agent\u002Fskills\u002Fmlops\u002Finference\u002Fobliteratus\u002Ftemplates\u002Fbatch-abliteration.yaml",[99,108,128,146,163,188],{"skillNo":100,"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":101,"sourceHtmlUrl":102,"categories":103,"keywords":107,"publishedAt":40},"01M6DY5FBHMSSWG32SRRBBHSCY","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[104,105,106],{"categoryNo":20,"categoryName":21,"taxonomyType":22,"taxonomyTypeDesc":23},{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},{"categoryNo":28,"categoryName":29,"taxonomyType":30,"taxonomyTypeDesc":31},[33,35,34,38,39,37,36],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":119,"publishedAt":40},"01M6DY55GWS0XA55ZCXTP13J7D","research","This skill should be used when researching a technical question, checking current API facts, comparing documented capabilities, or gathering primary-source evidence for a decision.","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fresearch\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fresearch\u002FSKILL.md",[115,118],{"categoryNo":116,"categoryName":117,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000021","资料检索与研究",{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},[110,120,121,122,123,124,125,126,35,127,39],"capabilities","api","decision","technical","question","evidence","facts","source",{"skillNo":129,"name":130,"nameZh":6,"description":131,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":132,"sourceHtmlUrl":133,"categories":134,"keywords":136,"publishedAt":40},"01M6DY4ZKCTSBBHRBYJ32B1K3Q","handoff","Summarize the current work so another session can continue it.","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fhandoff\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fhandoff\u002FSKILL.md",[135],{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},[130,137,138,139,140,141,142,143,144,145],"summarize","continue","work","session","next","focus","it","true","can",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":150,"sourceHtmlUrl":151,"categories":152,"keywords":154,"publishedAt":40},"01M6DY4RMF43ZK6E4EC1PM0A8N","diagnosing-bugs","This skill should be used when diagnosing a reported bug, intermittent failure, stuck operation, or performance regression and isolating its cause with reproducible evidence.","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fdiagnosing-bugs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fdiagnosing-bugs\u002FSKILL.md",[153],{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},[155,156,39,157,158,159,125,160,161,162],"bugs","diagnosing bugs","performance","Reproducible","regression","bug","operation","with",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":167,"sourceHtmlUrl":168,"categories":169,"keywords":177,"publishedAt":40},"01M6DY4NAXPP2ZQ4GH1Z339RQH","codebase-design","This skill should be used when designing a module interface, reducing coupling, choosing dependency seams, improving testability, or comparing architecture alternatives.","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcodebase-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcodebase-design\u002FSKILL.md",[170,173,174],{"categoryNo":171,"categoryName":172,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},{"categoryNo":175,"categoryName":176,"taxonomyType":30,"taxonomyTypeDesc":31},"01JBSEEDCAT000000000000032","设计师",[178,179,180,181,182,183,184,185,186,187,39],"codebase","codebase design","design","dependency","architecture","module","testability","coupling","interface","alternatives",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":192,"sourceHtmlUrl":193,"categories":194,"keywords":202,"publishedAt":40},"01M6DY4JJYJBGA4VMNRQ7636BF","code-review","This skill should be used when reviewing a branch, pull request, working tree, or changes since a commit for repository standards and the user's requested behavior.","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcode-review\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FOyadotAI\u002Foya-browser\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fcode-review\u002FSKILL.md",[195,198,199],{"categoryNo":196,"categoryName":197,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000007","代码审查",{"categoryNo":25,"categoryName":26,"taxonomyType":22,"taxonomyTypeDesc":23},{"categoryNo":200,"categoryName":201,"taxonomyType":30,"taxonomyTypeDesc":31},"01JBSEEDCAT000000000000030","开发工程师",[203,204,205,206,207,208,209,210,211,212,213,214,35,215,216,39],"review","code review","code","commit","pull request","pull","repository","branch","behavior","user","standards","tree","changes","request"]