Document Decisions and Architecture Clearly
Teams lose context when important technical decisions remain in chat, code comments, or individual memory. This skill turns architectural reasoning, API guidance, project instructions, and release changes into structured documentation.
Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.
Review the Skillstore skill "documentation-and-adrs" from https://skillstore.io/skills/addyosmani-documentation-and-adrs.md and its manifest at https://skillstore.io/api/skills/addyosmani-documentation-and-adrs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.
Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.
Использование «documentation-and-adrs». We chose PostgreSQL over SQLite and MongoDB for a multi-user task application.
Ожидаемый результат:
An ADR outline with status, context, relational data requirements, alternatives considered, the PostgreSQL decision, and operational consequences.
Использование «documentation-and-adrs». Document a task creation endpoint that requires a title and returns an identifier.
Ожидаемый результат:
API reference guidance covering the request fields, validation errors, authentication expectations, response details, and a short usage example.
Использование «documentation-and-adrs». Create onboarding documentation for a project with a development server and test suite.
Ожидаемый результат:
All 28 external-command detections are Markdown examples or inline command references in SKILL.md, not executable behavior. The environment-file and system-reconnaissance detections also point to documentation examples, and no prompt injection or data-exfiltration intent was found.
Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.
https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/addyosmani-documentation-and-adrs?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/addyosmani-documentation-and-adrs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/addyosmani-documentation-and-adrs/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/addyosmani-documentation-and-adrs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>addyosmani. (2026). documentation-and-adrs security audit report (audit version 2) [Author version unspecified]. Skillstore. https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2@techreport{addyosmani-addyosmani-documentation-and-adrs-2026,
author = {addyosmani},
title = {documentation-and-adrs security audit report (audit version 2)},
institution = {Skillstore},
year = {2026},
number = {2},
url = {https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "documentation-and-adrs security audit report (audit version 2)"
version: "unspecified"
type: report
authors:
- name: "addyosmani"
date-released: "2026-09-19"
url: "https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2"
identifiers:
- type: other
value: "skillstore:addyosmani-documentation-and-adrs:audit:2"
description: "Skillstore immutable audit report identifier"
Create an ADR that compares options, explains trade-offs, records the selected approach, and preserves consequences for future maintainers.
Draft consistent API documentation covering inputs, outputs, errors, authentication expectations, and representative usage guidance.
Build a practical README, changelog structure, and agent guidance so contributors can understand setup, architecture, conventions, and recent changes.
Create a concise ADR for this decision: [decision]. Include context, selected approach, two alternatives, consequences, status, and date. Use clear headings.
Review the repository context I provide and identify its ADR location, file format, numbering pattern, and headings. Then draft an ADR for [decision] that follows those conventions.
Write documentation for this public API: [API details]. Cover parameters, return values, validation, authentication, errors, and one realistic example. State unknowns instead of inventing behavior.
Design a documentation update for [project]. Propose ADRs for durable decisions, README sections for onboarding, API reference coverage, changelog entries, agent guidance, and a verification checklist. Preserve existing conventions and identify missing evidence.
Автор
addyosmaniЛицензия
MIT
Ревизия Skillstore
r2
Примечание о версии
Автор не указал версию.
Ссылка
5d5054f8a23586f9b500fece1cb613a9dffc787b
Актуальность поддержки
19.09.2026
Использование
2 загрузок · 0 просмотров
Структура файлов
📄 SKILL.md
Проверка кода по пяти критериям качества
Изменения в коде могут скрывать проблемы с корректностью, безопасностью, архитектурой, читаемостью и производительностью. Этот навык применяет структурированный процесс проверки и предоставляет приоритизированную обратную связь с конкретными рекомендациями.
Clarify User Intent Before You Build
Underspecified requests cause teams to build the wrong outcome and discover misalignment late. This skill runs a focused, one-question interview that turns ambiguity into confirmed intent.
Plan Work Into Verifiable Tasks
Large or vague software work can hide dependencies, missing acceptance criteria, and verification gaps. This skill converts a specification into ordered task slices with checkpoints, scope guidance, and clear completion conditions.
Build Accessible, Production-Ready Frontends
Frontend work can become inconsistent, inaccessible, or difficult to maintain. This skill guides component architecture, responsive layouts, state handling, and polished user experiences.
Debug Errors with a Root-Cause Workflow
Debugging failures by guesswork wastes time and can hide the real cause. This skill provides a repeatable process for reproducing, isolating, fixing, and verifying problems.
Structure Better Context for Coding Agents
Coding agents lose accuracy when context is incomplete, stale, or excessive. This skill provides practical structures for focused sessions, durable rules, and reliable handoffs.
Создание профессиональной документации в Markdown
от AutumnsGrove
Командам нужна понятная проектная документация, которая остается согласованной в README-файлах, журналах изменений и руководствах по участию. Markdown Pro предоставляет шаблоны, структуру и вспомогательные рабочие процессы для качественной технической документации.
Write Clear Go Documentation
от samber
Go projects often have incomplete comments, examples, and contributor guidance that slow adoption and maintenance. This skill provides structured guidance for writing, reviewing, and organizing documentation that matches Go conventions.
Генерация двуязычной документации для релизов GitHub
от ZhanlinCui
Создание качественной документации для релизов требует времени и согласованности между языками. Этот навык автоматизирует генерацию двуязычных README-файлов на основе существующих метаданных репозитория.
Документирование архитектуры репозитория
от AstraBit-CPT
Документация репозитория часто устаревает, когда меняются зависимости, API и шаги настройки. Этот навык анализирует структуру и интеграции, а затем помогает создавать README, API-документацию, архитектурную документацию, руководства для контрибьюторов и документацию по интеграциям.
Создавайте отличные каркасы репозиториев
от zjsxply
Создание качественно оформленного awesome-списка требует продуманной структуры, правил внесения вкладов и шагов проверки. Этот skill генерирует сфокусированный каркас репозитория на основе темы и начальных ресурсов.
Создавайте понятную техническую документацию
от shubhamsaboo
Командам часто сложно превращать технические детали в понятную документацию. Этот навык структурирует README, справочники API, учебные материалы и руководства для Claude, Codex и Claude Code.