conversion-agency/agentic-seo-skills / skills/seo-skills-creator
seo-skills-creator
VerifiedWhen the user wants to create, rewrite, evaluate, or improve an Agentic SEO skill. Also use when planning a skill-loop run or converting a formal contract skill into a narrative self-sufficient skill.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.7 KB |
| evals/fixture.md | markdown | 822 B |
| references/approval-rubric.md | markdown | 2.9 KB |
| references/examples/seo-analysis-v1-outline.md | markdown | 667 B |
| references/template-skill.md | markdown | 4.6 KB |
references/approval-rubric.md
View on GitHub# Narrative Skill Decision Rubric
Use this rubric to evaluate a single `SKILL.md` plus the executor output produced from its fixture.
Threshold: 90/100.
Maximum iterations: 5 before escalation.
## Scoring
| Dimension | Weight | Scoring | Criteria |
|---|---:|---|---|
| Task clarity | 20 | 0-100 | The skill teaches one task in under 3 minutes of reading and makes routing boundaries clear. |
| Self-sufficiency | 15 | 0 or 100 | The executor can complete the fixture from this skill alone. Required reads from `_shared/` score 0. |
| Examples | 15 | 0 or 100 | At least one strong example and one weak example are present and materially contrast behavior. |
| Output format | 15 | 0-100 | The deliverable schema/template is specific enough for stable executor output. |
| Critical points | 10 | 0-100 | Non-negotiable invariants are explicit: anti-fabrication, source/synthesis separation, decision/check gates, language fidelity. |
| Behavioral parity | 15 | 0-100 | Tool-using skills preserve expected files, gates, and JSON/YAML surfaces in fixture output. Redistribute to clarity and self-sufficiency when no tool is involved. |
| Length within budget | 10 | 0 or 100 | Main `SKILL.md` is 60-250 lines, unless a router/meta skill has a documented reason. |
## Required Findings Format
```json
{
"score": 0,
"threshold": 90,
"decision": "keep|revise|escalate",
"breakdown": {
"task_clarity": 0,
"self_sufficiency": 0,
"examples": 0,
"output_format": 0,
"critical_points": 0,
"behavioral_parity": 0,
"length_within_budget": 0
},
"defects": [
{
"severity": "blocker|major|minor",
"evidence": "quote or precise reference",
"impact": "why this hurts execution",
"fix": "actionable change"
}
],
"notes": []
}
```
## Automatic Blockers
- Fabricates keyword volume, backlinks, credentials, awards, clients, or proof.
- Allows an authorial brain page to change without a source-backed `tipo: decisao` entry in `project/brain/log.md`.
- Stores drafts or hypotheses in `project/brain/`.
- Tells a nontechnical user to run terminal commands as the primary decision or sensitive-input flow.
- Strips accents from pt-BR human-facing prose.
- Requires shared references for normal execution.
- Missing or wrong `metadata.category` in the frontmatter — valid values are `report`, `delivery`, `setup`, `meta`, `router`, `contract`, `alias`.
- Category-incompatible close contract: a `report`, `delivery`, or `setup` skill missing the literal YAML `browser_prompt:` block in the Output Format with the canonical consent line for its category; OR a `meta` or `alias` skill declaring a YAML `browser_prompt:` block (their artifacts live outside `project/`).
- Canonical consent line altered, reworded, or softened — must be exactly `Posso abrir o Web Companion para você ver a análise?` for reports and `Posso abrir o Web Companion para você revisar esta entrega?` for delivery/setup.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |