GH-SKILL-PUBLISH(1)            GitHub CLI manual           GH-SKILL-PUBLISH(1)



<?><?><?> (NAME)
       gh-skill-publish - <?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?>)



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh skill publish [<directory>] [flags]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (Agent Skills
       specification) <?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> (release) <?><?>
       <?><?><?><?><?><?><?>.


       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> install
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

       o skills/*/SKILL.md

       o skills/{scope}/*/SKILL.md

       o */SKILL.md (<?><?> <?><?><?> <?><?><?><?>)

       o plugins/{scope}/skills/*/SKILL.md


       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>:

       o <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
         agentskills.io <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>

       o <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
         <?><?><?><?><?> <?><?><?><?>

       o <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
         <?><?><?><?><?><?><?><?><?> (name <?> description) <?><?><?><?>
         <?><?><?><?><?> <?><?><?><?><?>

       o <?><?><?><?> allowed-tools <?><?> <?><?><?><?> <?><?><?><?> <?>
         <?><?> <?><?> <?><?><?><?><?>

       o <?><?><?><?><?><?><?><?> <?><?><?> (metadata.github-*) <?><?>
         <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>


       <?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

       o <?><?><?><?><?><?> <?><?><?><?><?> (topic) <?><?> <?><?><?> agent-
         skills <?><?> <?><?><?><?>

       o <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?>
         <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
         <?><?> semver <?><?><?><?><?><?><?> <?><?><?>)

       o <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
         <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?>


       <?><?> --dry-run <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?> --tag <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> --fix <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> publish <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       --dry-run
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>


       --fix  <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>)


       --tag <string>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?> v1.0.0)



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       $ gh skill publish

       # <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?><?><?>)
       $ gh skill publish --tag v1.0.0

       # <?><?><?> <?><?><?><?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?>)
       $ gh skill publish --dry-run

       # <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       $ gh skill publish --fix




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-skill(1)

                                   Sep 2026                GH-SKILL-PUBLISH(1)