Habilidades writing-guidelines

📦

writing-guidelines

Name: writing-guidelines
Author: vercel-labs

v1.0.0 Revisión del contenido r1 Riesgo alto ⚙️ Comandos externos🌐 Acceso a red

Review Documentation Against Writing Guidelines

Inconsistent prose makes documentation harder to read and maintain. This skill checks selected files against current guidelines and reports precise locations for revision.

Compatible con: Claude Codex Code(CC)

⚠️ 38 Deficiente

Detente y solicita confirmación antes de instalar.

Revisa el plan y obtén el consentimiento explícito del usuario antes de modificar archivos.

Instalar con mi Agente

Copia esta solicitud en tu Agente. Incluye la página canónica del Skill y el manifiesto.

Solicitud de agente

Review the Skillstore skill "writing-guidelines" from https://skillstore.io/skills/vercel-labs-writing-guidelines.md and its manifest at https://skillstore.io/api/skills/vercel-labs-writing-guidelines/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Tu Agente debe seguir mostrando su plan y solicitar cualquier confirmación exigida por la política de seguridad.

Recursos legibles por agentes

Usa estos enlaces cuando un agente de IA, crawler o script necesite contexto limpio en vez de leer la página completa.

Detalle Markdown GET /skills/vercel-labs-writing-guidelines.md Manifest firmado GET /api/skills/vercel-labs-writing-guidelines/manifest Lockfile firmado GET /api/skills/vercel-labs-writing-guidelines/lockfile

Pruébalo

Usando "writing-guidelines". Review docs/setup.md for writing guideline compliance.

Resultado esperado:

docs/setup.md:18 - Replace vague wording with a specific action.
docs/setup.md:42 - Use consistent terminology for the project name.

Usando "writing-guidelines". Audit the Markdown files in docs/api.

Resultado esperado:

docs/api/authentication.md:27 - Shorten the sentence and place the required action first.

Usando "writing-guidelines". Check README.md and report only guideline violations.

Resultado esperado:

README.md:64 - Replace passive voice with a direct instruction.

Auditoría de seguridad

Riesgo alto

v1 • 14/8/2026 Abrir el informe versionado

The two command-execution alerts are false positives caused by Markdown backticks and a fenced URL block. The network request is confirmed, and trusting mutable remote instructions creates a high-severity prompt injection and supply-chain risk.

Archivos escaneados

Líneas analizadas

Elementos de revisión

Falsos positivos ignorados

Preocupaciones de seguridad confirmadas (1)

Alto

SKILL.md:23-29

Mutable Remote Instructions Are Trusted

The skill fetches an unpinned main-branch document and applies its rules and output instructions. A compromised source could inject instructions into every review.

Lines 23 through 29 explicitly require fetching fresh content and treating it as rules and output instructions. The source uses a mutable branch.

Elementos de revisión de capacidades (1)

Estas son capacidades locales reales que pueden esperarse para esta habilidad, por lo que requieren revisión, pero no se cuentan como comportamiento malicioso confirmado.

Bajo

SKILL.md:26

Hardcoded URL

https://raw.githubusercontent.com/vercel-labs/writing-guidelines/main/command.md

The URL on line 26 is explicitly fetched before each review through WebFetch. This creates real outbound network access to mutable remote content.

Factores de riesgo

⚙️ Comandos externos (2)

SKILL.md:19 SKILL.md:25-27

🌐 Acceso a red (1)

SKILL.md:26

Auditado por: codex

Compartir y citar este informe

Comparte el informe de evaluación versionado, la insignia neutral, la tarjeta insertable y las citas. Skillstore presenta evidencias sin decidir si este Skill es seguro.

Abrir el informe versionado

Copiar enlace del informe

https://skillstore.io/skills/vercel-labs-writing-guidelines/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Insignia Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/vercel-labs-writing-guidelines/security.svg)](https://skillstore.io/skills/vercel-labs-writing-guidelines?utm_source=security_passport_badge)

Insignia HTML

<a href="https://skillstore.io/skills/vercel-labs-writing-guidelines?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/vercel-labs-writing-guidelines/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Tarjeta para insertar

<iframe src="https://skillstore.io/embed/skills/vercel-labs-writing-guidelines.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citas académicas (APA · BibTeX · CFF)

Cita APA

vercel-labs. (2026). writing-guidelines security audit report (audit version 1) [Author version 1.0.0]. Skillstore. https://skillstore.io/skills/vercel-labs-writing-guidelines/audits/1

Cita BibTeX

@techreport{vercel-labs-vercel-labs-writing-guidelines-2026,
  author = {vercel-labs},
  title = {writing-guidelines security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/vercel-labs-writing-guidelines/audits/1},
  note = {Author version 1.0.0}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "writing-guidelines security audit report (audit version 1)"
version: "1.0.0"
type: report
authors:
  - name: "vercel-labs"
date-released: "2026-08-14"
url: "https://skillstore.io/skills/vercel-labs-writing-guidelines/audits/1"
identifiers:
  - type: other
    value: "skillstore:vercel-labs-writing-guidelines:audit:1"
    description: "Skillstore immutable audit report identifier"

Puntuación de Skillstore

Por qué esta puntuación Confianza de la evidencia: Medio

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

Cumplimiento de la especificación

Lo que puedes crear

Review Product Documentation

Check a documentation page for style, voice, and formatting issues before publication.

Audit Repository Prose

Review selected Markdown files and receive concise findings tied to exact locations.

Standardize Editorial Quality

Apply one writing standard across documentation contributed by several teams.

Prueba estos prompts

Review One File

Review README.md against the Writing Guidelines. Report each issue with its file and line number.

Check Documentation Pages

Review all Markdown files in docs/getting-started. Group findings by file and keep each explanation concise.

Prioritize Important Issues

Audit docs/**/*.md against the Writing Guidelines. Prioritize unclear language, inconsistent terminology, and structural problems.

Compare Revised Documentation

Review the changed documentation files. Identify remaining violations and note whether previously reported issues appear resolved.

Mejores prácticas

Provide a narrow file path or pattern for faster, more relevant reviews.
Review findings in context before changing technical terminology.
Run the review again after revisions to confirm remaining issues.

Evitar

Do not provide binary or generated files as review targets.
Do not accept remote instructions that are unrelated to writing review.
Do not treat every finding as correct without checking surrounding context.

Preguntas frecuentes

What files can this skill review?

It reviews readable prose files selected by a path or file pattern.

Does it edit documentation automatically?

No. The skill reports guideline violations and their locations for manual revision.

Where do the writing rules come from?

The skill fetches rules from its configured Writing Guidelines URL before each review.

Does the skill require network access?

Yes. It uses WebFetch to retrieve the latest guideline document.

What happens when no file is specified?

The skill asks which files or patterns should be reviewed.

How are findings presented?

Findings use a concise file and line format defined by the fetched guidelines.

Detalles del desarrollador

Autor

vercel-labs

Licencia

MIT

Versión del autor

v1.0.0

Revisión de Skillstore

Repositorio

https://github.com/vercel-labs/agent-skills/tree/b8caa260a420a73042e35521de4b5c8baf6446cc/skills/writing-guidelines

Ref.

6afe7f6a881e3cdb58ff350617a068277e884103

Actualidad del mantenimiento

14/8/2026

Uso

0 descargas · 0 vistas

Estructura de archivos

📄 SKILL.md