docs(skills): add gnhf orchestration skill#108
Merged
Conversation
kunchenguid
reviewed
Apr 30, 2026
Contributor
Author
|
Any files besides the |
Owner
|
Thanks @Arcadia822 - the skill content looks great and matches what we discussed in #98. Could you rebase on |
b5faeff to
a43a87f
Compare
Owner
|
@Arcadia822 i just resolved the conflict and merged. thank you for the contribution! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a
gnhfskill that helps an outer coding agent operate GNHF as the execution loop for long-running agent work.The user-authored contribution here is the
skills/gnhf/SKILL.mdskill itself. The package metadata, README/AGENTS documentation updates, and focused packaging test were added after no-mistakes review/test/documentation feedback so the skill is actually shipped and documented with the npm package.The skill keeps the surface area intentionally small: it distinguishes Hands-Off runs from Companion-supervised runs, provides a launch prompt skeleton, and documents when companion steering, follow-up findings, and morning review should happen. The package file list now includes
skillsso the skill is published with the npm package, and the README points users to the bundled skill file.Agent-Managed Runs
The skill gives host agents a repeatable way to translate a user request into a GNHF invocation with explicit constraints, verification expectations, and an observable stop condition. Both modes include short English and Chinese examples to make trigger intent clear.
Example Hands-Off requests:
Companion Supervision
Companion-only sections cover steering, review, and review-finding follow-up so agents do not confuse hands-off execution with active quality supervision.
Example Companion requests:
Validation
skills/gnhf/SKILL.mdis included innpm pack --dry-run --json.AGENTS.mdso the package description no longer implies the npm artifact is only a single-file bundle.Pipeline
Updates from git push no-mistakes:
npx vitest run test/gnhf-skill.test.tsafternpm ciin the isolated worktree.Note: no-mistakes briefly pushed an extra
excalidraw.login an auto-generated follow-up commit. That file was unrelated and was removed before opening this PR.Refs #98