Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

promote-check

Estrellas2

Forks0

Actualizado6 de julio de 2026 a las 04:08

Promotion preflight gate for the agent-skills marketplace. Run before promoting a skill from a sandbox plugin to an official one, or before opening a promotion PR, to get a go / no-go verdict. Audit-first: it chains the deterministic skill-audit signals, marketplace/registry alignment, and version + CHANGELOG presence, and BLOCKS (no-go) on any unresolved finding, citing the failing gate. User-invoked only. For fixing what it surfaces use skill-studio:skill-enhance; for the release wiring use repo-governance:skill-maintainer.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Ejecutar en Manus

Fuente

felipeblassioli

felipeblassioli/agent-skills

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ejecutar en Manus

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Otras ocupaciones informáticasOcupaciones informáticas y matemáticas·SOC 15-1299

Explorador de archivos

6 archivos

SKILL.md

readonly

name	promote-check
description	Promotion preflight gate for the agent-skills marketplace. Run before promoting a skill from a sandbox plugin to an official one, or before opening a promotion PR, to get a go / no-go verdict. Audit-first: it chains the deterministic skill-audit signals, marketplace/registry alignment, and version + CHANGELOG presence, and BLOCKS (no-go) on any unresolved finding, citing the failing gate. User-invoked only. For fixing what it surfaces use skill-studio:skill-enhance; for the release wiring use repo-governance:skill-maintainer.
disable-model-invocation	true

Promote Check

A user-invoked preflight gate for promoting a skill into an official plugin. Established policy is audit-first: a promotion must fix everything the audit surfaces, not just pass a binary. This skill makes that discipline mechanical and hard to skip — it emits a go / no-go verdict and names the gate that failed.

It composes existing tooling; it does not re-implement any check. Fixing findings is skill-studio:skill-enhance; version/CHANGELOG/marketplace wiring and the actual move is repo-governance:skill-maintainer. This skill only decides go / no-go.

Apply when

Deciding whether a candidate skill is ready to graduate from a sandbox plugin (e.g. blassioli) to an official one.
Before opening a promotion PR, as the preflight that must be green first.

Do not apply when

Authoring or fixing a skill → skill-studio:skill-create / skill-enhance.
Doing the version bump / CHANGELOG / marketplace move → repo-governance:skill-maintainer.
Auditing for judgment dimensions (archetype fit, description quality) → skill-studio:skill-audit (this gate consumes only its deterministic signals).

Procedure

Run the deterministic gate against the candidate skill directory:

bash "${CLAUDE_SKILL_DIR}/scripts/promote-check.sh" plugins/<plugin>/skills/<skill>
# add --json for machine-readable output

Read the verdict:

go — every gate passed. The candidate is clear for the skill-maintainer promotion workflow. go is necessary, not sufficient: judgment dimensions (archetype fit, description quality, real traction) are still the owner's call.
no-go — one or more gates failed. The output names each failing gate and the finding. Route the fixes (audit findings → skill-enhance; drift/version/ changelog → skill-maintainer), then re-run until go.

The gates run in order and every failure is reported (not just the first). See references/gates.md for exactly what each gate checks, the exit codes, and the tools it wraps.

Gates

Gate	Blocks when	Wraps
`audit`	unresolved mechanical finding (name↔folder, orphan/dangling refs, non-exec scripts, relative bundled-script calls, cross-package links, missing/invalid metadata)	`skill-studio` `audit-skill.sh`
`alignment`	marketplace ↔ plugin.json ↔ metadata ↔ CHANGELOG ↔ registry drift	`scripts/marketplace-consistency.sh`
`version`	`metadata.json` has no version	—
`changelog`	no `CHANGELOG.md`, or its top entry ≠ metadata version	—

Confirmation policy

This gate is read-only and side-effect-free; it never edits, versions, moves, or promotes anything. Acting on a go (the actual promotion) is skill-maintainer and carries its own confirmation policy.

Dependencies

scripts/marketplace-consistency.sh (the alignment gate) and plugins/skill-studio/.../audit-skill.sh (the audit gate) must exist in the repo. If either is missing the gate exits non-zero with a clear message rather than passing silently.

Maintainer validation commands for this skill package live in README.md.

Más de este repositorio

mismo repositorio

smart-prompt

felipeblassioli/agent-skills

Shapes a loose intent into a well-formed prompt for a Claude Code session that can gather context, use tools, and ask questions. Matches the intent to a validated archetype, fills its slots (objective, context to gather, anchors, clarify-first questions, acceptance criteria, verification, output contract), routes the tier via model-recommender, and self-checks the result with prompt-audit. Use when you have a rough idea of what to ask an agent and want it reshaped to hit a specific goal, when you type /smart-prompt with a loose instruction, or to turn "read X and study Y to figure out Z" into an executable agentic prompt.

2026-07-052

prompt-audit

felipeblassioli/agent-skills

Adversarially reviews a draft prompt against a versioned rule set to find what will make it underperform — archetype mismatch, wrong prescription level for the target model, the Fable reasoning-echo trap, negatives that should be positives, unstated expectations, rejected params, and more — then returns tagged findings (rule_id + severity) plus a rewritten, --fix-style prompt. Use when asked to review / audit / critique / improve a prompt, check whether a prompt is good, tighten a system prompt, or before shipping a prompt to a model.

2026-07-052

model-recommender

felipeblassioli/agent-skills

Recommends which Claude model and effort level to run for a task. Classifies the task into an archetype → tier + effort using the rubric in ~/.claude/model-profiles.md, then resolves today's model string from that file's tier_to_model. Use when deciding which model to use, routing a task or phase to a model, picking an effort level, choosing between Opus/Sonnet/Haiku/Fable, or when a task spans plan/implement/review phases that each want a different model.

2026-07-052

skill-audit

felipeblassioli/agent-skills

Audit a Claude skill for quality, context-efficiency, and best-practice compliance — classify its archetype, score the four principles and instruction craft, and return a report — or review a PORTFOLIO of skills for overlap and trigger collisions. Use when someone asks to audit, review, grade, "lint", or sanity-check a skill or plugin's quality; asks "does this skill follow best practices / is it well-scoped / is the description good enough to trigger / do these skills overlap or collide"; or wants a governance sweep across a set of skills. Read-only: it diagnoses and recommends, it does not edit. Do not use to create or scaffold a skill (use skill-create), to improve a skill or run eval/benchmark loops (use skill-enhance), or for versioning/release/CHANGELOG governance (use repo-governance:skill-maintainer).

2026-07-032

gh-post-code-review

felipeblassioli/agent-skills

Post a structured code review to a GitHub PR via `gh` CLI (REST API fallback for multi-comment / inline-anchored reviews). Maps BLOCKER/HIGH/MEDIUM/LOW/QUESTION sections to the right review event and inline anchors, parses ` ```start:end:path ` code refs, and adapts tone to the PR author. Use when you have a written code review and want it posted to a specific PR URL or number. Do NOT use to author the review itself, triage existing comments, or open/merge PRs.

2026-07-032

typescript-quality

felipeblassioli/agent-skills

TypeScript code quality patterns -- typed clients with timeouts, Zod input validation, structured domain errors, no any on public APIs, structured JSON logging with pino, OpenTelemetry tracing, and PII redaction. Use when adding external API calls, validating inputs, handling errors, or setting up logging.

2026-07-032

name	promote-check
description	Promotion preflight gate for the agent-skills marketplace. Run before promoting a skill from a sandbox plugin to an official one, or before opening a promotion PR, to get a go / no-go verdict. Audit-first: it chains the deterministic skill-audit signals, marketplace/registry alignment, and version + CHANGELOG presence, and BLOCKS (no-go) on any unresolved finding, citing the failing gate. User-invoked only. For fixing what it surfaces use skill-studio:skill-enhance; for the release wiring use repo-governance:skill-maintainer.
disable-model-invocation	true

Promote Check

Apply when

Deciding whether a candidate skill is ready to graduate from a sandbox plugin (e.g. blassioli) to an official one.
Before opening a promotion PR, as the preflight that must be green first.

Do not apply when

Authoring or fixing a skill → skill-studio:skill-create / skill-enhance.
Doing the version bump / CHANGELOG / marketplace move → repo-governance:skill-maintainer.
Auditing for judgment dimensions (archetype fit, description quality) → skill-studio:skill-audit (this gate consumes only its deterministic signals).

Procedure

Run the deterministic gate against the candidate skill directory:

bash "${CLAUDE_SKILL_DIR}/scripts/promote-check.sh" plugins/<plugin>/skills/<skill>
# add --json for machine-readable output

Read the verdict:

go — every gate passed. The candidate is clear for the skill-maintainer promotion workflow. go is necessary, not sufficient: judgment dimensions (archetype fit, description quality, real traction) are still the owner's call.
no-go — one or more gates failed. The output names each failing gate and the finding. Route the fixes (audit findings → skill-enhance; drift/version/ changelog → skill-maintainer), then re-run until go.

The gates run in order and every failure is reported (not just the first). See references/gates.md for exactly what each gate checks, the exit codes, and the tools it wraps.

Gates

Gate	Blocks when	Wraps
`audit`	unresolved mechanical finding (name↔folder, orphan/dangling refs, non-exec scripts, relative bundled-script calls, cross-package links, missing/invalid metadata)	`skill-studio` `audit-skill.sh`
`alignment`	marketplace ↔ plugin.json ↔ metadata ↔ CHANGELOG ↔ registry drift	`scripts/marketplace-consistency.sh`
`version`	`metadata.json` has no version	—
`changelog`	no `CHANGELOG.md`, or its top entry ≠ metadata version	—

Confirmation policy

This gate is read-only and side-effect-free; it never edits, versions, moves, or promotes anything. Acting on a go (the actual promotion) is skill-maintainer and carries its own confirmation policy.

Dependencies

scripts/marketplace-consistency.sh (the alignment gate) and plugins/skill-studio/.../audit-skill.sh (the audit gate) must exist in the repo. If either is missing the gate exits non-zero with a clear message rather than passing silently.

Maintainer validation commands for this skill package live in README.md.