BF ai-staff-agent
AI Staff Agent — the production workhorse that handles boilerplate code generation, data cleaning pipelines, copy variant generation, and KM (Knowledge Management) research pulls. Use this skill whenever the user needs to scaffold code, clean/transform datasets, generate multiple copy variations from a brief, or research and compile knowledge base content. Triggers on requests like "generate boilerplate", "clean this data", "create copy variants", "pull research on", "scaffold a component", "preprocess this CSV", "write 5 versions of this copy", "research and summarize", or any task that involves repetitive production work, data transformation, content variation, or knowledge gathering. Make sure to use this skill whenever the user mentions scaffolding, data wrangling, copywriting variants, research compilation, or asks for any form of production-ready utility output, even if they don't explicitly name this agent. NOT for: final quality review (use ai-qa-agent), complex architectural design (handle directly), or deployment/DevOps operations.
AI Staff Agent — the production workhorse that handles boilerplate code generation, data cleaning pipelines, copy variant generation, and KM (Knowledge…
As a process F 50/100 · Will not run — References files that are not bundled: references/brand-voice-guide.md
How to improve
- Shorten the description to 1024 characters.
- The text references files that are not there: add them or drop the references.
- Your own cases (evals/evals.json, 4–6 real requests with expected answers): the full check would then run those instead of a model-drafted suite.
- A spec.yaml with trigger phrases and assertions — a behaviour contract for CI; `skilltest init` writes a template.
Guard findings · 0
✓ No critical or high findings
Files scanned: 4. Evidence is masked. Grey chips explain why severity was lowered.
Against the Agent Skills spec
- error
description-longdescription is 1058 chars, limit 1024 - warning
missing-refreference to a missing file: references/brand-voice-guide.md
Process rating: all ten parameters 50/100
- 0Tools and files. 1 referenced file(s) missing: references/brand-voice-guide.md
- 0Inputs and preconditions. Does not say what the process needs to start
- 0Progress reporting. Says nothing while it works
- 30Running it twice. 4 mutating operations with no state check
- 55Failures and branches. 1 branches
- 60Steps. 55 steps, 5 vague phrases
- 60Result and completion. Output format stated, no completion criterion
- 100When it triggers. States when to use and when not to
- 100Consistency. Name and required fields are in place
- 100Execution cost. Instruction body is 1926 tokens
Everything here is measured from the skill text rather than judged by a model, so the numbers are checkable. A parameter weighs more when it is a more common reason for the process to stall.
Quality signals
- +3Description length 1057: 120–800 characters recommended
- -5TODO / placeholder text left in the skill
- -4Absolute local paths (C:\Users, /home/…): not portable
- +2Single-language instructions
- +5Description quotes 8 example trigger phrases
- +4Description says when NOT to use the skill
- +4Structure: 17 headings
- +3Step-by-step instructions: 55 items
- +3Output format is stated explicitly
- +4Has examples (2 code blocks)
- +1License stated
Quality base 70; lint remarks subtract, signals add up to 100. Result: 54.