Agent skill

Architecture Spec

by gustavscirulis in gustavscirulis/snapgrid

Generates technical architecture specification from PRD. An agent skill from gustavscirulis/snapgrid.

Custom licenceAuto-check passedProduct & Project Management

Install Architecture Spec

skills CLI
$ npx skills add gustavscirulis/snapgrid --skill architecture-spec -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gustavscirulis/snapgrid architecture-spec --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gustavscirulis/snapgrid.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/skills/product/architecture-spec .claude/skills/architecture-spec && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-spec
GitHub stars
116
Used in
1 other repo
Token cost
~9k tokens
SKILL.md length
2,063 words
Files
1
Skills in repo
118
Repo updated
First seen
Licence
Custom licence

At a glance

Generates technical architecture specification from PRD. An agent skill from gustavscirulis/snapgrid.

  • Works in 9 steps: Data Flow → Security & Privacy → Performance Considerations → …
  • Creating ARCHITECTURE.md
  • SKILL.md covers Metadata, Activation, Description and Prerequisites, plus 7 more sections
  • Reaches github.com and apple.com

What it does

Architecture Spec is an agent skill from gustavscirulis/snapgrid. Generates technical architecture specification from PRD. Covers architecture pattern, tech stack, data models, and app structure. Use when creating ARCHITECTURE.md or designing system architecture.

Its SKILL.md is about 9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering PRD writing and Software architecture. It works with iOS and macOS. The repository describes itself as: SnapGrid is an open-source Mac app for collecting, organizing, and analyzing UI screenshots. It uses AI to automatically detect UI components and patterns, making it a powerful…

When your agent uses it

  • Creating ARCHITECTURE.md
  • Designing system architecture

Example prompts

  • “Use the architecture-spec skill to generate technical architecture specification from PRD. An agent skill from gustavscirulis/snapgrid”
  • “/architecture-spec”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Glob, Grep, AskUserQuestion

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Data Flow
  2. Security & Privacy
  3. Performance Considerations
  4. Testing Strategy
  5. Deployment & DevOps
  6. Technical Risks & Mitigations
  7. Future Considerations
  8. Documentation & Knowledge Sharing
  9. Success Metrics

What it can do on your machine

Read from SKILL.md and the folder at commit eb7eaf4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • Grep
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are swift, markdown, xml and yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • apple.com

    Also links to:

    • developer.apple.com
    • swift.org
    • docs.swift.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Spec loads about 9k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 2,063 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,063 words (~9,036 tokens).

“Generate technical architecture specification for iOS/macOS app.”

— opening of SKILL.md by gustavscirulis, Custom licence
name
architecture-spec
allowed-tools
Read, Write, Glob, Grep, AskUserQuestion

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/skills/product/architecture-spec of gustavscirulis/snapgrid.

Open the folder on GitHubat commit eb7eaf4

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gustavscirulis/snapgrid, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Architecture Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Spec this skillgustavscirulis/snapgrid1161 repos~9kAutomated safety check: PassCustom licence
Rankupyan-labs/yan-skills213—~5.1kAutomated safety check: NotesMIT
Pmstudio Arbcoco-research/coco513—~1.3kAutomated safety check: PassCustom licence
ArchitectureAlexPEClub/ai-coding-starter-kit382—~1.1kAutomated safety check: PassNone
Software Architecture Analysismagnus919/hermes-profiles289—~2.8kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80511 repos~3.3kAutomated safety check: PassCustom licence

Similar skills

  • Rankup

    yan-labs/yan-skills

    独立开发者的项目全生命周期管理:需求验证、选词选品、建站或做原生 App、上线接入、SEO/GEO 获客、支付变现、监控迭代与跨会话接力。以下情况使用:用户提到 rankup 或 /rankup(check、review、init;doctor 仅指整理项目 .rankup 记录);当前目录或工作区有…

    213 GitHub stars~5.1k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • Pmstudio Arb

    coco-research/coco

    Generate an Architecture Review Board (ARB) presentation in Coco Inc's standard 11-slide format.

    513 GitHub stars~1.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Architecture

    AlexPEClub/ai-coding-starter-kit

    Design PM-friendly technical architecture for features. An agent skill from AlexPEClub/ai-coding-starter-kit.

    382 GitHub stars~1.1k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Software Architecture Analysis

    magnus919/hermes-profiles

    Reverse-engineer a software codebase to understand architecture, data flow, privacy posture, and feature surface — then produce a clean-room design document, PRD, or migration plan that re-imagines…

    289 GitHub stars~2.8k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    805 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed

More from gustavscirulis/snapgrid

All 118 skills in this repo
  • Interaction Design

    gustavscirulis/snapgrid

    Design and implement microinteractions, motion design, transitions, and user feedback patterns.

    116 GitHub starsUsed in 3 repos~2k tokens
    Auto-check passed
  • Account Deletion

    gustavscirulis/snapgrid

    Generates an Apple-compliant account deletion flow with multi-step confirmation UI, optional data export, configurable grace period, Keychain cleanup, and server-side deletion request.

    116 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check: notes
  • Alarmkit

    gustavscirulis/snapgrid

    AlarmKit integration for scheduling alarms and timers with custom UI, Live Activities, and snooze support.

    116 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Analytics Interpretation

    gustavscirulis/snapgrid

    Interpret app metrics and make data-driven decisions. An agent skill from gustavscirulis/snapgrid.

    116 GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check passed
  • Analytics Setup

    gustavscirulis/snapgrid

    Generates protocol-based analytics infrastructure with swappable providers (TelemetryDeck, Firebase, Mixpanel).

    116 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: notes
  • Announcement Banner

    gustavscirulis/snapgrid

    Generates an in-app announcement banner system with remote configuration, scheduling, deep link actions, and dismiss tracking.

    116 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check: notes

Works with

Questions about Architecture Spec

What does Architecture Spec do?

Generates technical architecture specification from PRD. An agent skill from gustavscirulis/snapgrid. Architecture Spec is an agent skill from gustavscirulis/snapgrid. Generates technical architecture specification from PRD.

When should I use Architecture Spec?

Architecture Spec fits situations like: creating ARCHITECTURE.md; designing system architecture.

How do I install Architecture Spec in Claude Code?

Run `npx skills add gustavscirulis/snapgrid --skill architecture-spec -a claude-code`. Or copy the skill folder (.claude/skills/skills/product/architecture-spec in gustavscirulis/snapgrid) into .claude/skills/architecture-spec in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Spec in Codex?

Run `npx skills add gustavscirulis/snapgrid --skill architecture-spec -a codex`. Or copy the skill folder (.claude/skills/skills/product/architecture-spec in gustavscirulis/snapgrid) into .agents/skills/architecture-spec in your project. Codex loads it when a task matches its description.

Can I use Architecture Spec in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gustavscirulis/snapgrid --skill architecture-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-spec, .gemini/skills/architecture-spec, .github/skills/architecture-spec and .opencode/skills/architecture-spec in your project.

What does Architecture Spec need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Spec is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Glob, Grep, AskUserQuestion.

Does Architecture Spec access the network?

SKILL.md names 5 domains. In commands or code: github.com and apple.com; the agent is likely to contact these when it follows the instructions. As links in the text: developer.apple.com, swift.org and docs.swift.org. This is read from the text; nothing was executed.

Is Architecture Spec safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Spec use?

Architecture Spec has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Architecture Spec use?

About 9k tokens (SKILL.md is roughly 36k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architecture Spec?

Skills that share tags, products or a category with Architecture Spec: Rankup (yan-labs/yan-skills, 213 stars), Pmstudio Arb (coco-research/coco, 513 stars), Architecture (AlexPEClub/ai-coding-starter-kit, 382 stars) and Software Architecture Analysis (magnus919/hermes-profiles, 289 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Spec?

gustavscirulis (a GitHub user) maintains it in gustavscirulis/snapgrid, which has 116 GitHub stars. The repository holds 118 skills in this directory. The repository was last updated on April 30, 2026.

Source: gustavscirulis/snapgrid on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.