review-spec

Name: review-spec
Availability: InStock
Author: suzuki3jp

Review Notion spec pages for security and implementation gaps via comments.

15|3|Updated Oct 17, 2024

Search Tags:#workflow #documentation #security #commenting #compliance #notion #spec-review

Ready to run

npx skills add https://github.com/suzuki3jp/PlaylistWizard --skill review-spec-suzuki3jp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: review-spec
Source: https://github.com/suzuki3jp/PlaylistWizard/tree/main/.agents/skills/review-spec
Command: npx skills add https://github.com/suzuki3jp/PlaylistWizard --skill review-spec-suzuki3jp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion spec pages often diverge from implementation, causing security gaps, misalignment, and unclear ownership. This skill reads the specification, assesses for security risks, completeness, and consistency with existing code, and reports findings as Notion comments without altering the original spec.

Core Features & Use Cases

Reviews Notion spec pages for security, edge cases, and implementation-consistency.
Generates Notion comments with severity levels and concrete improvement suggestions.
Facilitates clarification by surfacing ambiguities and prompting questions when needed.

Quick Start

Review the target Notion spec page and post a structured comment outlining issues and suggested fixes.

Frequently Asked Questions about review-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I review Notion specifications for security and implementation gaps?▼

Reviewing Notion specifications for security and implementation gaps involves reading the spec page and project context to evaluate risks across authentication and data handling, then posting actionable comments with severity annotations directly on the Notion page.

What is the best way to check if a Notion spec page aligns with existing code?▼

Checking if a Notion spec page aligns with existing code requires fetching the page via a strict workflow, comparing the specification against repository artifacts, and surfacing inconsistencies as structured Notion comments.

How does automated spec commenting work without altering the original Notion page?▼

Automated spec commenting works without altering the original Notion page by generating comments with severity levels and concrete improvement suggestions, leaving the source text untouched while facilitating clarification of ambiguities.

Can I use repository artifacts to assess Notion specification completeness?▼

Using repository artifacts to assess Notion specification completeness involves operating on Notion pages referenced by arguments, comparing them against code to evaluate risk, and producing a concise summary of findings.

What are the limitations of automated Notion spec review tools?▼

Limitations of automated Notion spec review tools include relying on referenced Notion pages and repository artifacts for context, meaning they cannot evaluate risks without access to both the specification and the existing codebase.