skills.rest
suzuki3jp
suzuki3jpCOMMUNITY
Explore all skills by this author →
Website𝕏@_suzuki3jpGitHub

review-spec

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
One-click install
npx skills add https://github.com/suzuki3jp/PlaylistWizard --skill review-spec-suzuki3jp
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
HellKaiser45HellKaiser45

notion-spec-to-implementation

Fetch Notion spec pages and create linked implementation plans with tasks.

Community
Advanced
bhanukushwahbhanukushwah

verify-work

Validate built software features through conversational testing with persistent state.

Community
Advanced
WellApp-aiWellApp-ai
341

notion-sync

Synchronize Notion task updates across PR creation, branch init, and status changes.

Official
Intermediate
trypanictrypanic

go-code-quality-check

Run go vet, staticcheck, and semgrep to generate severity-grouped fix plans.

Community
Advanced