[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C49KK3TPNRC328ZX2AV44H":3,"skill-same:01M7C49KK3TPNRC328ZX2AV44H":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":13,"repositoryHtmlUrl":42,"repositoryHomepageUrl":6,"ownerHtmlUrl":43,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":44,"install":45,"resources":58},"01M7C49KK3TPNRC328ZX2AV44H","mercury-skill-authoring",null,"Author in-repo SKILL.md files: frontmatter and structure.","fengwhang\u002Fmercury","fengwhang","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F325040254?v=4","01M7C3K54Y41KVGPHEMKEP9X70","01M7C3K55NTZ4B36YP2JY1NMJ0",0,"MIT","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Fskills\u002Fsoftware-development\u002Fmercury-skill-authoring\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: mercury-skill-authoring\ndescription: \"Author in-repo SKILL.md files: frontmatter and structure.\"\nversion: 3.0.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  mercury:\n    tags: [skills, authoring, hermes-agent, conventions, skill-md]\n    related_skills: [requesting-code-review]\n---\n\n# Authoring Mercury Skills\n\nThis established skill slug describes Mercury's source tree. Add bundled skills\nto `hermes\u002Fskills\u002F\u003Ccategory>\u002F\u003Cname>\u002F`, or optional integrations to\n`hermes\u002Foptional-skills\u002F\u003Ccategory>\u002F\u003Cname>\u002F`. Personal `skill_manage` operations\nwrite to the installed shared library, not this repository.\n\n## Workflow\n\n1. Read the applicable `AGENTS.md` and inspect related skills before adding a\n   sibling. Extend a suitable skill and consolidate duplicate slash names.\n2. Keep YAML frontmatter at byte zero with `name` and a concise `description`;\n   preserve human attribution, license, supported platforms, and real integration\n   IDs. Existing `metadata.mercury` is the loader's metadata contract, not a\n   statement that this is stock Hermes.\n3. Put reusable decisions and required setup in `SKILL.md`. Move substantial\n   conditional instructions into referenced files. A skill must have a useful\n   workflow of its own rather than forwarding to a duplicate skill.\n4. Use Mercury CLI commands and installation variables. Both engines share\n   `$MERCURY_HOME\u002Fskills`; named profiles own their `config\u002F*.md` prompt files.\n   Use `mercury config path` \u002F `env-path` to resolve settings and secrets. For\n   nightly, use `mercury-nightly` throughout.\n5. Match the engine's actual tools. Examples of Hermes `terminal`, `read_file`,\n   or `skill_view` are not automatically omp tool names. Mercury delegation\n   uses omp's sole `task` role. Do not reintroduce stock role routing, shared\n   profile personas, or Hermes smart approvals into omp.\n6. Validate frontmatter, names, platform requirements, reference links, and\n   helper scripts. Run meaningful behavior tests through `hermes\u002Fscripts\u002Frun_tests.sh`\n   with temporary homes; do not test copies of headings or prose. Regenerate\n   skill catalog pages when names\u002Ffrontmatter change and preserve unrelated work.\n7. Review the diff. Commit, publish, or release only when the task authorizes it.\n\n## Platform and security checks\n\nAudit subprocesses and dependencies before claiming platform support. A macOS\nCLI makes a skill macOS-specific; a cross-platform CLI requires verification on\nits supported hosts. Document MCP\u002Fprovider prerequisites and preserve SDK package\nnames when their upstream spelling is the real runtime contract.\n\nCredentials belong in the secrets path, behavior in configuration. Helpers that\nedit YAML must preserve Mercury's `models`, `approvals`, `hermes`, and `omp`\nsubtrees and operate on the selected profile. Avoid hardcoded stable homes in\nnightly workflows. Do not restart live services while validating a skill unless\nthe user has explicitly requested that operation.\n\n## Validation\n\nUse the repository's skill manager validator and actual skill discovery. Names\nand slash-command slugs must be unique across bundled and optional source skills.\nAll local references and scripts must resolve. If consolidating shipped skills,\nensure updates retire pristine obsolete copies while retaining custom user work.\n","# Authoring Mercury Skills\n\nThis established skill slug describes Mercury's source tree. Add bundled skills\nto `hermes\u002Fskills\u002F\u003Ccategory>\u002F\u003Cname>\u002F`, or optional integrations to\n`hermes\u002Foptional-skills\u002F\u003Ccategory>\u002F\u003Cname>\u002F`. Personal `skill_manage` operations\nwrite to the installed shared library, not this repository.\n\n## Workflow\n\n1. Read the applicable `AGENTS.md` and inspect related skills before adding a\n   sibling. Extend a suitable skill and consolidate duplicate slash names.\n2. Keep YAML frontmatter at byte zero with `name` and a concise `description`;\n   preserve human attribution, license, supported platforms, and real integration\n   IDs. Existing `metadata.mercury` is the loader's metadata contract, not a\n   statement that this is stock Hermes.\n3. Put reusable decisions and required setup in `SKILL.md`. Move substantial\n   conditional instructions into referenced files. A skill must have a useful\n   workflow of its own rather than forwarding to a duplicate skill.\n4. Use Mercury CLI commands and installation variables. Both engines share\n   `$MERCURY_HOME\u002Fskills`; named profiles own their `config\u002F*.md` prompt files.\n   Use `mercury config path` \u002F `env-path` to resolve settings and secrets. For\n   nightly, use `mercury-nightly` throughout.\n5. Match the engine's actual tools. Examples of Hermes `terminal`, `read_file`,\n   or `skill_view` are not automatically omp tool names. Mercury delegation\n   uses omp's sole `task` role. Do not reintroduce stock role routing, shared\n   profile personas, or Hermes smart approvals into omp.\n6. Validate frontmatter, names, platform requirements, reference links, and\n   helper scripts. Run meaningful behavior tests through `hermes\u002Fscripts\u002Frun_tests.sh`\n   with temporary homes; do not test copies of headings or prose. Regenerate\n   skill catalog pages when names\u002Ffrontmatter change and preserve unrelated work.\n7. Review the diff. Commit, publish, or release only when the task authorizes it.\n\n## Platform and security checks\n\nAudit subprocesses and dependencies before claiming platform support. A macOS\nCLI makes a skill macOS-specific; a cross-platform CLI requires verification on\nits supported hosts. Document MCP\u002Fprovider prerequisites and preserve SDK package\nnames when their upstream spelling is the real runtime contract.\n\nCredentials belong in the secrets path, behavior in configuration. Helpers that\nedit YAML must preserve Mercury's `models`, `approvals`, `hermes`, and `omp`\nsubtrees and operate on the selected profile. Avoid hardcoded stable homes in\nnightly workflows. Do not restart live services while validating a skill unless\nthe user has explicitly requested that operation.\n\n## Validation\n\nUse the repository's skill manager validator and actual skill discovery. Names\nand slash-command slugs must be unique across bundled and optional source skills.\nAll local references and scripts must resolve. If consolidating shipped skills,\nensure updates retire pristine obsolete copies while retaining custom user work.\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":35,"description":7},"Hermes Agent","3.0.0",{"mercury":26},{"tags":27,"related_skills":33},[28,29,30,31,32],"skills","authoring","hermes-agent","conventions","skill-md",[34],"requesting-code-review",[36,37,38],"linux","macos","windows","main","94a12cab2ce32e2020d179b5d579d0cbcbd0f206","hermes\u002Fskills\u002Fsoftware-development\u002Fmercury-skill-authoring","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury","https:\u002F\u002Fgithub.com\u002Ffengwhang","2026-10-09 08:26:42",{"source":8,"skillName":5,"commands":46,"prompt":56,"zipAvailable":57},[47,50,53],{"tool":48,"command":49},"npx","npx skills add fengwhang\u002Fmercury --skill mercury-skill-authoring",{"tool":51,"command":52},"bunx","bunx skills add fengwhang\u002Fmercury --skill mercury-skill-authoring",{"tool":54,"command":55},"pnpm","pnpm dlx skills add fengwhang\u002Fmercury --skill mercury-skill-authoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fhermes\u002Fskills\u002Fsoftware-development\u002Fmercury-skill-authoring\u002FSKILL.md",true,[],[60,67,74,81,87,94],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M7C4BTY3ND38CN200ZCTH6NV","greet","A greeting skill for testing","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Fmarketplace\u002Ffixtures\u002Fvalid-marketplace\u002Fplugins\u002Fhello-plugin\u002Fskills\u002Fgreet\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7C4BSNZTPW8JR5NGCQXGSEZ","valid-skill","A valid skill for testing purposes.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fvalid-skill\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7C4BRA7J8C06KSVW100F1W1","unknown-field","A skill with an unknown frontmatter field.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Funknown-field\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M7C4BNB04KQGCJ835JE8AR13","no-frontmatter","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fno-frontmatter\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":18},"01M7C4BM38TZFYT1AJ6SKHPZZ2","child-skill","A nested skill in a subdirectory.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fnested\u002Fchild-skill\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":18},"01M7C4BJDN7RFFCM28CGX15Q97","different-name","A skill with a name that doesn't match the directory.","https:\u002F\u002Fgithub.com\u002Ffengwhang\u002Fmercury\u002Fblob\u002Fmain\u002Fomp\u002Fpackages\u002Fcoding-agent\u002Ftest\u002Ffixtures\u002Fskills\u002Fname-mismatch\u002FSKILL.md",[],[]]