Skip to content

aiskillstore/marketplace / skills/abdulsamad94/project-architecture

project-architecture

Verified

Overview of the project's tech stack, directory structure, and architectural patterns.

FileKindSize
SKILL.mdskill md1.5 KB
skill-report.jsonconfig22.2 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-18T09:51:53.572Z",
    "slug": "abdulsamad94-project-architecture",
    "source_url": "https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/architecture",
    "source_ref": "master",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "8860dd2f041d6c3e78b84a1db5f66204e4675d0106f1524334a223650603b410",
    "tree_hash": "cf39b9df0c81ea3355936477a531f07458639c0bceb2029a1dda8470d1f38312",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-18T09:51:53.714103Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-18T09:51:53.736089Z ERROR codex_models_manage…"
        },
        {
          "agent": "claude",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "Project Architecture",
    "description": "Documents a Next.js and Docusaurus project architecture, including the technology stack, directories, authentication integration, styling, and development commands.",
    "summary": "Reference guide for understanding a hybrid Next.js and Docusaurus application.",
    "icon": "📦",
    "author": "AbdulSamad94",
    "license": "MIT",
    "tags": [
      "project-architecture",
      "nextjs",
      "docusaurus",
      "typescript",
      "developer-onboarding"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 18 static findings are false positives caused by Markdown inline code formatting and descriptive documentation. The skill contains no executable code, network behavior, prompt injection, or system reconnaissance instructions.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 12,
            "line_end": 12
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "SKILL.md",
            "line_start": 19,
            "line_end": 19
          },
          {
            "file": "SKILL.md",
            "line_start": 20,
            "line_end": 20
          },
          {
            "file": "SKILL.md",
            "line_start": 21,
            "line_end": 21
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 22
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 28,
            "line_end": 28
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 33
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 36
          },
          {
            "file": "SKILL.md",
            "line_start": 37,
            "line_end": 37
          },
          {
            "file": "SKILL.md",
            "line_start": 38,
            "line_end": 38
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 12,
        "line_end": 12,
        "snippet": "- **Docs/Content**: Docusaurus (in `textbook/` directory)"
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "- **Auth**: Better Auth (`better-auth`)"
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 19,
        "line_end": 19,
        "snippet": "- `/app`: Next.js App Router pages and layouts."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 20,
        "line_end": 20,
        "snippet": "- `/components`: Reusable UI components."
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 21,
        "line_end": 21,
        "snippet": "- `/auth`: Authentication related components (forms, etc.)."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 22,
        "snippet": "- `/lib`: Utility functions and shared logic."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 23,
        "snippet": "- `auth-client.ts`: Better Auth client configuration."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "- `auth.ts`: Better Auth server configuration."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 25,
        "snippet": "- `/db`: Database schema and connection logic."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "- `/drizzle`: Migrations."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 27,
        "line_end": 27,
        "snippet": "- `/textbook`: Docusaurus instance for documentation/content."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "- `/src`: Docusaurus source files."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 32,
        "snippet": "- **Auth Integration**: Shared authentication state between Next.js and Docusaurus via cookies/sessi"
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 33,
        "snippet": "- **Styling**: Global Tailwind styles in `app/globals.css`. Docusaurus has its own theme in `textboo"
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 36,
        "snippet": "- Run root app: `npm run dev:root`"
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 37,
        "line_end": 37,
        "snippet": "- Run docs app: `npm run dev:docs`"
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 38,
        "line_end": 38,
        "snippet": "- Run both: `npm run dev`"
      },
      {
        "id": "blocker:SKILL.md:31:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 31,
        "line_end": 31,
        "snippet": "- **Hybrid App**: Combines a Next.js web app (marketing, auth, dashboard) with a Docusaurus document"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the textbook directory name in Markdown. They do not execute a command or contain an executable instruction."
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the Better Auth package name in Markdown. No shell invocation or dynamic command construction is present."
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /app directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /components directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /auth directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /lib directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format a source file name in a documentation list. No command is invoked."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format a source file name in a documentation list. No command is invoked."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /db directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /drizzle directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /textbook directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the /src directory path in a documentation list. This is not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format the AuthBar component name in descriptive prose. There is no command execution."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks only format stylesheet paths in descriptive prose. There is no command execution."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is a documented, explicit npm development command, not embedded executable code. It contains no untrusted input or hidden behavior."
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is a documented, explicit npm development command, not embedded executable code. It contains no untrusted input or hidden behavior."
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is a documented, explicit npm development command, not embedded executable code. It contains no untrusted input or hidden behavior."
      },
      {
        "id": "blocker:SKILL.md:31:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The text describes a hybrid application architecture. It does not collect host details, inspect the system, or perform reconnaissance."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 39,
    "audit_model": "claude",
    "audited_at": "2026-07-18T09:51:53.572Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Understand Your Project Architecture",
    "value_statement": "New contributors can struggle to locate services and understand how a hybrid web application fits together. This skill provides a concise reference for the stack, directory responsibilities, integration patterns, and local development commands.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "project architecture",
      "Next.js architecture",
      "Docusaurus documentation",
      "TypeScript project",
      "developer onboarding",
      "Better Auth",
      "Drizzle ORM"
    ],
    "actual_capabilities": [
      "Lists the Next.js, TypeScript, Tailwind CSS, Docusaurus, PostgreSQL, Drizzle ORM, and Better Auth stack.",
      "Explains the responsibilities of the app, components, lib, db, drizzle, and textbook directories.",
      "Identifies the client and server authentication configuration files.",
      "Describes shared authentication state between the web application and documentation site.",
      "Shows the documented commands for starting the root app, documentation app, or both."
    ],
    "limitations": [
      "Describes only the architecture documented in the skill file.",
      "Does not inspect the current repository or validate that paths still exist.",
      "Does not provide deployment, database migration, or security configuration procedures.",
      "Does not generate diagrams or modify project files."
    ],
    "use_cases": [
      {
        "title": "Onboard a new developer",
        "description": "Give a new contributor a quick map of the stack and directory responsibilities.",
        "target_user": "Development team lead"
      },
      {
        "title": "Plan a feature location",
        "description": "Use the directory guidance to decide where a page, component, authentication change, or migration belongs.",
        "target_user": "Application developer"
      },
      {
        "title": "Explain the platform structure",
        "description": "Summarize how the web application and documentation site share authentication and styling responsibilities.",
        "target_user": "Technical writer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Get a project overview",
        "scenario": "Beginner",
        "prompt": "Summarize this project architecture in simple terms. Include the main technologies and what each major directory contains."
      },
      {
        "title": "Find the right directory",
        "scenario": "Intermediate",
        "prompt": "I need to add a reusable authenticated interface element. Based on this architecture, which directory and related files should I review first?"
      },
      {
        "title": "Trace authentication integration",
        "scenario": "Intermediate",
        "prompt": "Explain how authentication is organized across the Next.js app and Docusaurus site. Identify the documented configuration and integration points."
      },
      {
        "title": "Prepare an onboarding brief",
        "scenario": "Advanced",
        "prompt": "Create a concise onboarding brief for this project. Cover the stack, directory ownership, hybrid application pattern, styling, and local development commands."
      }
    ],
    "output_examples": [
      {
        "input": "Where should I look for database schema and migrations?",
        "output": [
          "Database schema and connection logic are documented in /db.",
          "Migration files are documented in /drizzle.",
          "The project uses PostgreSQL through NeonDB and Drizzle ORM."
        ]
      },
      {
        "input": "How do I start the applications locally?",
        "output": [
          "Use npm run dev:root for the root application.",
          "Use npm run dev:docs for the documentation application.",
          "Use npm run dev to start both applications."
        ]
      },
      {
        "input": "How is the application structured?",
        "output": "The project combines a Next.js web application for marketing, authentication, and dashboards with a Docusaurus documentation site. Shared authentication state uses cookies or sessions through AuthBar."
      }
    ],
    "best_practices": [
      "Use this guide as an orientation aid before editing unfamiliar directories.",
      "Confirm current file paths and scripts in the repository before making changes.",
      "Keep web application and documentation changes aligned when authentication or styling is shared."
    ],
    "anti_patterns": [
      "Do not treat the directory summary as a substitute for reading the current implementation.",
      "Do not assume undocumented services, routes, or environment variables exist.",
      "Do not run development commands in production environments."
    ],
    "faq": [
      {
        "question": "What kind of project does this skill describe?",
        "answer": "It describes a hybrid Next.js web application and Docusaurus documentation site."
      },
      {
        "question": "Which technologies are listed?",
        "answer": "The guide lists Next.js, TypeScript, Tailwind CSS, Docusaurus, Better Auth, PostgreSQL, NeonDB, Drizzle ORM, and Lucide React."
      },
      {
        "question": "Where are reusable interface components documented?",
        "answer": "Reusable interface components are documented in the /components directory."
      },
      {
        "question": "Where is authentication configuration documented?",
        "answer": "The guide identifies auth-client.ts for client configuration and auth.ts for server configuration under /lib."
      },
      {
        "question": "Does this skill inspect my repository?",
        "answer": "No. It provides the documented architecture and does not inspect repository contents."
      },
      {
        "question": "Can it start the project for me?",
        "answer": "No. It documents npm commands that you may run after reviewing the project requirements."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 39
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall