Навыки writing-guidelines
📦

writing-guidelines

v1.0.0 Ревизия содержимого r1 Высокий риск ⚙️ Внешние команды🌐 Доступ к сети

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.

Поддерживает: Claude Codex Code(CC)
⚠️ 38 Плохо

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента
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.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Markdown-детали GET /skills/vercel-labs-writing-guidelines.md Подписанный manifest GET /api/skills/vercel-labs-writing-guidelines/manifest Подписанный lockfile GET /api/skills/vercel-labs-writing-guidelines/lockfile

Протестировать

Использование «writing-guidelines». Review docs/setup.md for writing guideline compliance.

Ожидаемый результат:

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

Использование «writing-guidelines». Audit the Markdown files in docs/api.

Ожидаемый результат:

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

Использование «writing-guidelines». Check README.md and report only guideline violations.

Ожидаемый результат:

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

Аудит безопасности

Высокий риск
v1 • 14.08.2026 Открыть версионный отчет

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.

1
Просканировано файлов
40
Проанализировано строк
1
Пункты проверки
0
Ложные срабатывания проигнорированы

Подтверждённые проблемы безопасности (1)

Высокий
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.
Пункты проверки возможностей (1)

Это реальные локальные возможности, которые могут ожидаться для этого навыка, поэтому они требуют проверки, но не считаются подтверждённым вредоносным поведением.

Низкий
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.

Факторы риска

⚙️ Внешние команды (2)
SKILL.md:19 SKILL.md:25-27
🌐 Доступ к сети (1)
SKILL.md:26
Аудитор:: codex
Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет
Оценка безопасности

Копировать ссылку на отчёт

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

Значок 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)

Значок 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>

Встраиваемая карточка

<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>
Академические ссылки (APA · BibTeX · CFF)

Цитата 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

Цитата 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"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Средний
55
Архитектура
100
Сопровождаемость
87
Контент
65
Сообщество
83
Соответствие спецификации

Что вы можете построить

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.

Попробуйте эти промпты

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.

Лучшие практики

  • 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.

Избегать

  • 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.

Часто задаваемые вопросы

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.

Сведения для разработчиков

Автор

vercel-labs

Лицензия

MIT

Версия автора

v1.0.0

Ревизия Skillstore

r1

Репозиторий

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

Ссылка

6afe7f6a881e3cdb58ff350617a068277e884103

Актуальность поддержки

14.08.2026

Использование

0 загрузок · 0 просмотров

Структура файлов

📄 SKILL.md