drillan/docs-sync
.agents/skills/docs-sync/SKILL.md
Synchronizes documentation (README.md, CHANGELOG.md, API docs) with implementation. Preserves user content outside speckit markers. Updates are non-destructive and clearly delineated. Always run after /speckit.implement completes.
$ install --global
skillsauthnpx skillsauth add drillan/mixseek-plus docs-syncInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 4, 2026, 6:27 PM4.9s2 files scanned
SKILL.md
- name:
- docs-sync
- description:
- >
- version:
- 0.0.1
- license:
- MIT
- compatibility:
- Requires spec kit artifacts
- author:
- drillan
- category:
- automation
- repository:
- https://github.com/drillan/speckit-gates
- internal:
- true
docs-sync
Synchronizes documentation with implementation after /speckit.implement completes.
Purpose
This skill automatically updates documentation to reflect the implemented features. It:
- Updates README.md: Adds/updates usage section with implementation details
- Updates CHANGELOG.md: Adds entries for new features and changes
- Updates API docs: Synchronizes API documentation with contracts
- Preserves user content: Content outside speckit markers is never modified
Marker System
docs-sync uses HTML comment markers to delineate auto-generated sections:
<!-- speckit:start:section-name -->
Auto-generated content here
<!-- speckit:end:section-name -->
Content outside these markers is preserved exactly as-is.
Output
The skill outputs a DocsSyncResult showing:
- Files created, updated, or unchanged
- Sections modified within each file
- Diff summary (lines added/removed/changed)
- Any errors encountered
Usage
This skill runs automatically after /speckit.implement. You can also run it manually:
npx skills run docs-sync
Exit Codes
| Code | Status | Meaning | |------|--------|---------| | 0 | Success | All updates successful | | 1 | Partial | Some updates failed | | 3 | Error | Required files missing |
Sections Updated
README.md
| Section | Marker | Content Source |
|---------|--------|----------------|
| Usage | <!-- speckit:start:usage --> | spec.md user stories |
| Installation | <!-- speckit:start:installation --> | plan.md dependencies |
| Features | <!-- speckit:start:features --> | spec.md functional requirements |
CHANGELOG.md
| Section | Marker | Content Source |
|---------|--------|----------------|
| Unreleased | <!-- speckit:start:unreleased --> | tasks.md completed tasks |
Preservation Rules
- Content before the first marker is always preserved
- Content after the last marker is always preserved
- Content between different marker pairs is always preserved
- Only content within matching marker pairs is updated
- If no markers exist, content is appended with new markers
Error Handling
- Missing markers: Creates new markers and adds content
- Malformed markers: Reports error, skips that section
- File permissions: Reports error, continues with other files
- Missing source files: Reports which sources are unavailable
Related Skills
drillan/mixseek-workspace-init
tools
VerifiedTrustedCommunity
MixSeekワークスペースを初期化し、設定ファイル用ディレクトリ構造を作成します。「ワークスペースを初期化」「mixseekのセットアップ」「設定ディレクトリを作成」「新しいプロジェクトを始める」といった依頼で使用してください。
1SKILL.mdUpdated Apr 4, 2026
drillan/mixseek-team-config
development
VerifiedTrustedCommunity
MixSeekのチーム設定ファイル（team.toml）を生成します。「チームを作成」「エージェント設定を生成」「Web検索チームを作って」「分析チームを設定」といった依頼で使用してください。Leader AgentとMember Agentの構成を定義します。
1SKILL.mdUpdated Apr 4, 2026
drillan/mixseek-prompt-builder
development
VerifiedTrustedCommunity
MixSeekのプロンプトビルダー設定ファイル（prompt_builder.toml）を生成します。「プロンプトを設定」「プロンプトビルダーを作成」「ラウンド別プロンプト」といった依頼で使用してください。
1SKILL.mdUpdated Apr 4, 2026
drillan/mixseek-orchestrator-config
data-ai
VerifiedTrustedCommunity
MixSeekのオーケストレーター設定ファイル（orchestrator.toml）を生成します。「オーケストレーターを設定」「チーム競合設定」「複数チームで競わせる」「マルチチーム実行設定」といった依頼で使用してください。複数チームを並列実行して最良の結果を選択する設定を定義します。
1SKILL.mdUpdated Apr 4, 2026