Can it tell which stage my ADD is currently in?

Yes, the skill includes logic to analyze content presence and checkpoint completion to determine if you are in the Context, Options Analysis, or Solution Design stage.

Does it support team-specific architectural rules?

Absolutely. It can load custom rules from a config/custom-rules.json file to apply specific team requirements alongside standard Salsify guidelines.

What does the review report look like?

The output is divided into three sections: an Executive Summary of readiness, a Structured Report of section statuses, and specific Inline Suggestions for improvements.

How does the skill access my design documents?

The skill uses the Atlassian Confluence MCP tool to fetch content using page IDs or URLs provided in your prompt, such as 'review ADD 123456789'.

Salsify Architecture Design Reviewer

Name: Salsify Architecture Design Reviewer
Author: jduarte

byjduarte

0•

Collaboration Tools

Reviews and provides structured feedback for Salsify Architecture Design Documents (ADDs) based on official template guidelines.

This skill automates the review of Salsify Architecture Design Documents (ADDs) by fetching content directly from Confluence and evaluating it against standardized engineering criteria. It intelligently detects the document's current stage—Context, Options Analysis, or Solution Design—to provide contextually relevant, constructive feedback. By checking for catalog hygiene, reviewer setup, and technical depth, it ensures design documents meet organizational quality standards while accelerating the overall engineering design and approval process.

Key Features

01Automated Confluence document retrieval via page ID or URL extraction

02Comprehensive feedback covering executive summaries and structured reports

03Intelligent stage detection for Context, Options Analysis, and Solution Design

040 GitHub stars

05Support for custom team-specific review rules via JSON configuration

06Validation of catalog hygiene, Jira links, and tagging conventions

Use Cases

01Auditing existing ADDs for metadata compliance and technical documentation standards

02Verifying document readiness and checklist completion before a formal review meeting

03Getting immediate pre-review feedback on a draft architecture proposal

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jduarte/claude-code-dotfiles review-add

For use in Claude.ai and ChatGPT

Download Skill