skill-authoring
- Repo stars 833
- Author repo openpocket
skill-authoring
Use this skill when converting a rough draft into a production-ready skill document.
Goal
Transform noisy step traces or draft markdown into a strict SKILL.md that is:
- deterministic to execute
- explicit about when to trigger
- explicit about failure handling
- valid against strict skill validation rules
Required Structure
- Frontmatter:
name(kebab-case, matches directory)description(one concise sentence)- optional
metadataJSON for triggers/requirements
- Body sections:
When To UsePreconditionsProcedureFailure HandlingCompletion Criteria
Refinement Rules
- Replace fragile coordinates with semantic UI targets whenever possible.
- Keep each procedure step one atomic action.
- Add at least one fallback path for common blockers (auth wall, empty state, loading timeout).
- If personal data is required, add
request_human_authguidance before UI actions. - Keep language concise and executable.
Validation Gate
Before promotion:
- Run strict skill validation.
- If validation fails, keep as draft and report issues.
- Promote only validated output.
- Fluxly category
- Documentation
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @pockebot · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Guided setup
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. Transform noisy step traces or draft markdown into a strict SKILL.md that is: deterministic to execute explicit about when to trigger
Frontmatter: name (kebab-case, matches directory) description (one concise sentence)
Replace fragile coordinates with semantic UI targets whenever possible. Keep each procedure step one atomic action. Add at least one fallback path for common blockers (auth wall, empty state, loading timeout).
Before promotion: Run strict skill validation. If validation fails, keep as draft and report issues.
# skill-authoring
Use this skill when converting a rough draft into a production-ready skill document.
## Goal
Transform noisy step traces or draft markdown into a strict `SKILL.md` that is:
1. deterministic to execute
2. explicit about when to trigger
3. explicit about failure handling
4. valid against strict skill validation rules
## Required Structure
1. Frontmatter:
- `name` (kebab-case, matches directory)
- `description` (one concise sentence)
- optional `metadata` JSON for triggers/requirements
2. Body sections:
- `When To Use`
- `Preconditions`
- `Procedure`
- `Failure Handling`
- `Completion Criteria`
## Refinement Rules
1. Replace fragile coordinates with semantic UI targets whenever possible.
2. Keep each procedure step one atomic action.
3. Add at least one fallback path for common blockers (auth wall, empty state, loading timeout).
4. If personal data is required, add `request_human_auth` guidance before UI actions.
5. Keep language concise and executable.
## Validation Gate
Before promotion:
1. Run strict skill validation.
2. If validation fails, keep as draft and report issues.
3. Promote only validated output. Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> Goal → Required Structure → Refinement Rules → Validation Gate
terms -> Use this skill when converting a rough draft into a production-ready skill document. · 1. deterministic to execute 2. · 1. Replace fragile coordinates with semantic UI targets whenever possible. · 1. Run strict skill validation.
files/cmd -> name · description · metadata · When To Use · Preconditions · Procedure · Failure Handling · Completion Criteria
body sha256 -> dc2488065483
Decide Fit First
Design Intent
How To Use It
Boundaries And Review