docs: add {{PLACEHOLDER}} reference table to CONTRIBUTING.md#757
Open
Gonzih wants to merge 1 commit intogarrytan:mainfrom
Open
docs: add {{PLACEHOLDER}} reference table to CONTRIBUTING.md#757Gonzih wants to merge 1 commit intogarrytan:mainfrom
Gonzih wants to merge 1 commit intogarrytan:mainfrom
Conversation
The CONTRIBUTING.md mentions {{BASE_BRANCH_DETECT}} in passing but
doesn't document the full set of available {{PLACEHOLDER}} tokens.
Contributors writing new skills have to grep the codebase to discover
what's available.
Add a reference table covering all 20+ placeholders with descriptions,
placement guidance, and a note on parameterized usage. This lives in the
"Editing SKILL.md files" section, directly after the existing pointer
to CLAUDE.md's template authoring guide.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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
1 participant
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.
Summary
CONTRIBUTING.md mentions
{{BASE_BRANCH_DETECT}}once but doesn't document the full set of available{{PLACEHOLDER}}tokens. Contributors writing new skills currently have to grepscripts/resolvers/index.tsandscripts/resolvers/*.tsto discover what's available.This adds a reference table in the "Editing SKILL.md files" section covering all 20+ placeholders with:
Why
The resolver system is one of gstack's most powerful features — it lets skills share battle-tested prose about learnings, design methodology, review workflows, and deploy detection without duplication. But it's entirely undiscoverable without reading the source. This table makes the system visible.
Practical impact: a new contributor writing their first skill will immediately know to add
{{LEARNINGS_SEARCH}}+{{LEARNINGS_LOG}}, pick the rightpreamble-tier, and use{{BASE_BRANCH_DETECT}}instead of hardcodingmain.What's NOT in this PR
The full behavior of each resolver lives in
scripts/resolvers/*.ts. This table only describes the intent and placement — not the full resolved output, which can be read from any generated SKILL.md.🤖 Generated with Claude Code