Skip to content
Back to skills

Spec Document

ASecurity

Standard format for spec documents.

  • 106 stars
  • 0 votes
  • 0 copies
  • 5 views
  • Added September 12, 2026
documentationshellsecurityperformance

Security analysis

A100/100

Scanned September 12, 2026

npx -y skills add archibate/dotfiles-opencode --skill spec-document --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Spec Document?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Spec Document
[![Security: A β€” Skills Directory](https://www.skillsdirectory.com/api/skills/archibate-spec-document/badge)](https://www.skillsdirectory.com/skills/archibate-spec-document)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: spec-document-format
description: |
    Standard format for spec documents.
---

## πŸ“„ Specification Document Format

All spec documents **MUST** follow this Markdown template.
The file should be stored under `specs/` with a meaningful name, e.g., `specs/feature-authentication.md`.

```markdown
# Specification: <Title>

## Metadata
- **Version**: <semver, e.g., 1.0.0>
- **Status**: Draft | Active | Realized | Regressible | Deprecated
- **Author**: <agent or user>
- **Created**: <YYYY-MM-DD>
- **Last Updated**: <YYYY-MM-DD>

## Overview
<Brief description of the feature or system>

## Requirements
### Functional Requirements
- FR-1: <description>
- FR-2: ...

### Non-functional Requirements
- NFR-1: <architecture, performance, security, etc.>

## Test Steps
<Step-by-step verification instructions. May be shell commands, manual actions, or both.>

## Acceptance Criteria
<Conditions that must be satisfied for completion>

## Change Log
| Date       | Version | Description       | Author     |
|------------|---------|-------------------|------------|
| <date>     | 1.0.0   | Initial draft     | <author>   |
```

### 🎯 Document Quality

When writting specification document:
- Focus on **big-picture**.
- DO NOT be too specific on implementation details.
- Avoid ambiguous wording.
- Include **edge cases** in test steps when appliable.
- DO NOT hallucinate.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.