因境施法，场景先行 · Redesign SKILL.md with scenario-driven workflows - #30
Merged
Merged
Conversation
added 2 commits
July 22, 2026 11:18
- Add YAML frontmatter (name + description) as required by skill-creator - Move 'when to use' triggers into description frontmatter - Use imperative form throughout - Reduce body to 88 lines (under 500 limit) - Add agents/openai.yaml with display_name, short_description, default_prompt - Remove verbose sections that Codex already knows
…lows - Replace command-listing with real usage scenarios: screenshot small text, form/receipt field extraction (detect-then-recognize two-step pattern), counting regions, verifying multimodal output, batch processing - Add decision flow diagram for command selection - Keep under 500 lines, imperative form, skill-creator spec compliant
birhantprkc
pushed a commit
to birhantprkc/light-ocr
that referenced
this pull request
Jul 29, 2026
…s#30) * docs(skill): 遵规重塑，简而可行 · conform SKILL.md to skill-creator spec - Add YAML frontmatter (name + description) as required by skill-creator - Move 'when to use' triggers into description frontmatter - Use imperative form throughout - Reduce body to 88 lines (under 500 limit) - Add agents/openai.yaml with display_name, short_description, default_prompt - Remove verbose sections that Codex already knows * docs(skill): 因境施法，场景先行 · redesign SKILL.md with scenario-driven workflows - Replace command-listing with real usage scenarios: screenshot small text, form/receipt field extraction (detect-then-recognize two-step pattern), counting regions, verifying multimodal output, batch processing - Add decision flow diagram for command selection - Keep under 500 lines, imperative form, skill-creator spec compliant --------- Co-authored-by: chenghan <chenghan@fazhitech.cn>
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
Redesign the local-ocr Agent Skill to follow skill-creator conventions with scenario-driven workflows.
Changes
SKILL.md
ame + description) as required by skill-creator spec — this is the triggering mechanism
agents/openai.yaml (new)
Validation
Fixes the SKILL.md from PR #29 which was command-listing without scenario design.