hf-l2-use-authoring-skills
This skill should be used when the user asks to "create a skill", "audit this skill", "refactor skills", "doctor agent skills", "check skill quality", "fix…
Skill by shynlee04
Chalk Labs
Need help deploying hf-l2-use-authoring-skills?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/shynlee04-hf-l2-use-authoring-skills
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: testing, security, agent-building
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Shell scripts
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/hf-l2-use-authoring-skills
Tools it pre-approves 6
From allowed-tools in SKILL.md: the agent may use these without asking you each time.
ReadWriteEditBashGlobGrep
What's inside
- Skill name
hf-l2-use-authoring-skills- Description
- This skill should be used when the user asks to "create a skill", "audit this skill", "refactor skills", "doctor agent skills", "check skill quality", "fix frontmatter", "skill pattern selection", "TDD for skills", "cross-platform skill compatibility", or "score skill quality".
- License
- MIT
- Allowed tools
- Read, Write, Edit, Bash, Glob, Grep
- Metadata
- role: domain-execution · layer: 4 · pattern: P2-hybrid
- Instructions
- 276 lines in SKILL.md · view on GitHub
Before installing
- Ships executable scripts
- Pre-approves any shell command
Files (33)
- SKILL.md
- evals.json · evals/
- trigger-queries.json · evals/
- post-tool-use.sh · hooks/
- pre-tool-use.sh · hooks/
- stop.sh · hooks/
- rich-gate-scorecard.md · metrics/
- 01-skill-anatomy.md · references/
- 02-frontmatter-standard.md · references/
- 03-three-patterns.md · references/
- 04-tdd-workflow.md · references/
- 05-skill-quality-matrix.md · references/
- 06-cross-platform-activation.md · references/
- 07-iterative-refinement.md · references/
- 08-conflict-detection.md · references/
- 09-script-authoring.md · references/
- 10-eval-lifecycle.md · references/
- 11-description-optimization.md · references/
- 12-anti-deception.md · references/
- check-complete.sh · scripts/
- check-overlaps.sh · scripts/
- gate-enforce.sh · scripts/
- init-session.sh · scripts/
- register-skill.sh · scripts/
- validate-gate.sh · scripts/
- validate-skill.sh · scripts/
- verify-hierarchy.sh · scripts/
- task_plan.md
- evals.json · templates/
- grading-rubric.json · templates/
- SKILL.md.template · templates/skill-scaffold/
- .gitkeep · templates/skill-scaffold/references/
- trigger-queries.json · templates/
SKILL.md (first lines)
## The Iron Law ``` NO SKILL WITHOUT TRIGGER PHRASES IN THE DESCRIPTION ``` <files_to_read> .opencode/skills/use-authoring-skills/references/01-skill-anatomy.md .opencode/skills/use-authoring-skills/references/02-frontmatter-standard.md .opencode/skills/use-authoring-skills/references/03-three-patterns.md .opencode/skills/use-authoring-skills/references/05-skill-quality-matrix.md .opencode/skills/use-authoring-skills/scripts/validate-gate.sh .opencode/skills/use-authoring-skills/scripts/validate-skill.sh .opencode/skills/use-authoring-skills/scripts/check-overlaps.sh .opencode/get-shit-done/references/thinking-models-execution.md </files_to_read> The description is the ONLY thing the agent sees before deciding to load a skill. If it doesn't contain specific phrases a user would say, the skill is invisible. Dead on arrival. **Not "the description should be good."** The description IS the skill. Without it, nothing else matters. ### What agents actually rationalize | What agents say | Reality | |-----------------|---------| | "The description is clear enough" | It says "provides guidance for skill development." Agent will never load it. | | "I'll add trigger phrases later" | Later never comes. The skill sits dead until someone audits it. | | "The references are too long, I'll summarize" | References ARE the value. SKILL.md points to them. Summarizing = losing knowledge. | | "This skill needs another skill to work" | Standalone contract. Push to load, don't require. If it can't work alone, it's not a skill — it's a chapter. | | "The script stub exits 0 so validation passes" | A stub that always passes is a lie. Remove it or make it real. | | "I'll keep the dead reference, it might be useful later" | Dead references are debt. The agent will try to load them, fail, and move on. | ## HIERARCHY ENFORCEMENT — Run This FIRST This skill is LAYER 4 in the loading chain (domain execution). Before any action: 1. **Verify hierarchy chain:** ```bash bash scripts/verify-hierarchy.sh use-authoring-skills ``` This checks that meta-builder exists and routed to this skill. 2. **Register this skill as loaded:** ```bash bash scripts/register-skill.sh use-authoring-skills ``` 3. **Prerequisites:** - `meta-builder` must exist (routing source) - Background skills should already be loaded by upstream skills **If hierarchy check fails → STOP. This skill should only be loaded after meta-builder routing.** # Use Authoring Skills ## MANDATORY FIRST STEP — Run This Before Anything Else **Every time this skill loads, run the preflight validator immediately:** ```bash bash scripts/validate-gate.sh <create|edit|audit> "<user-request>" <skill-dir> ``` - `<create>` — building a new skill from scratch or from a document - `<edit>` — modifying an existing skill - `<audit>` — reviewing/grading an existing skill - `<user-request>` — the user's exact words in quotes - `<skill-dir>` — directory where the skill lives (default: `.`) **If this exits non-zero, you are BLOCKED.** Fix the reported issue and re-run. Do not proceed to any other step until Gate 0 passes. ## Step-by-Step Checklist (Follow In Order) Copy this checklist into `task_plan.md` and check off each item as you complete it. **You may not skip steps.** ``` - [ ] STEP 1: Run validate-gate.sh — must exit 0 - [ ] STEP 2: Run decision tree below — pick ONE path - [ ] STEP 3: Load the ONE matching reference file (not all) - [ ] STEP 4: Ask questions if unclear (max 3, question tool only) - [ ] STEP 5: Write frontmatter — run validate-skill.sh - [ ] STEP 6: Write body — follow agentskills.io principles (see below) - [ ] STEP 7: Run validate-skill.sh — if FAIL, fix and repeat STEP 7 - [ ] STEP 8: Run check-overlaps.sh — if FAIL, fix and repeat STEP 8 - [ ] STEP 9: Dispatch critic subagent for review — if FAIL, fix and repeat STEP 9 - [ ] STEP 10: Final validate-gate.sh re-run — must exit 0 ``` ## Decision Tree — Pick Your Path ``` User says... → Load ───────────────────────────────────────────────────────── "create a skill" / "make a skill" → references/03-three-patterns.md "create a skill like this @file" → references/03-three-patterns.md (template path) "audit this skill" / "review skill" → references/05-skill-quality-matrix.md "fix triggers" / "skill not loading" → references/11-description-optimization.md "improve this skill" / "refactor" → references/07-iterative-refinement.md "skill overlaps with..." → references/08-conflict-detection.md "write evals for skill" → references/10-eval-lifecycle.md "write scripts for skill" → references/09-script-authoring.md "make skill work on X platform" → references/06-cross-platform-activation.md "doctor" / "what's wrong with..." → references/12-anti-deception.md ``` **Rule:** Load only ONE reference file from the decision tree. Do not load all references. ## agentskills.io Principles (Apply During STEP 6) These are the core design principles from agentskills.io. Apply them when writing skill content: 1. **Procedures over declarations** — Teach HOW to do something, not WHAT something is. Use imperative verbs: "Run this script", "Check the output", "If X, do Y". Avoid: "This skill handles...", "The agent should...". 2. **Defaults, not menus** — Pick one approach as the primary path. Mention alternatives in one sentence. Do not present 5 options and ask the agent to choose. Example: "Use `bash scripts/validate-skill.sh` to validate. For Python-only skills, `pytest` is an acceptable alternative." 3. **Match specificity to fragility** — Be prescriptive for fragile steps (file formats, YAML syntax, tool invocation). Be flexible for creative steps (body content, examples). Frontmatter format = prescriptive. Example scenarios = flexible. 4. **Checklists for multi-step workflows** — Any workflow with 3+ steps must be a checklist with `[ ]` items. Agents check items off as they go.
From shynlee04/hivemind-plugin, MIT.
Signals
- Stars
- 51
- Forks
- 16
- Open issues
- 21
- Last commit (this folder)
- May 10, 2026 (6 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/shynlee04/hivemind-plugin
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get hf-l2-use-authoring-skills running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
hf-l2-use-authoring-skills. Agent Mart. https://agentmart.dev/skills/shynlee04-hf-l2-use-authoring-skills (last updated 2026-10-24)