Skip to content

aiskillstore/marketplace / skills/abdulsamad94/docusaurus-advanced

docusaurus-advanced

Verified

Deep dive into the Docusaurus configuration, plugins, and custom fields.

FileKindSize
SKILL.mdskill md980 B
skill-report.jsonconfig18.1 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-18T09:48:56.871Z",
    "slug": "abdulsamad94-docusaurus-advanced",
    "source_url": "https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/docusaurus",
    "source_ref": "master",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "7a354b4abfb1fd3308d4e045e818e7cb1fee86c72006894fad84ce866246636f",
    "tree_hash": "f3c090b8777274f33798fd03f9e1149548f0eea4cb95b43ea5bd40290ec9a1cf",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-18T09:48:57.002850Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-18T09:48:57.025231Z ERROR codex_models_manage…"
        },
        {
          "agent": "claude",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "Docusaurus Advanced",
    "description": "Guides configuration of Docusaurus custom fields, presets, navigation, themes, and MDX content.",
    "summary": "Configure advanced Docusaurus features with clear project-specific guidance.",
    "icon": "📦",
    "author": "AbdulSamad94",
    "license": "MIT",
    "tags": [
      "docusaurus",
      "documentation",
      "typescript",
      "mdx",
      "configuration"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "env_access"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 14 static findings are false positives caused by Markdown backticks, a loopback development URL, and a narrowly scoped environment-variable example. The skill contains documentation only and shows no command execution, network activity, secret access, or prompt-injection intent.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 9,
            "line_end": 9
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          },
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 19
          },
          {
            "file": "SKILL.md",
            "line_start": 19,
            "line_end": 22
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 27
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:9:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 9,
        "line_end": 9,
        "snippet": "- **File**: `textbook/docusaurus.config.ts`"
      },
      {
        "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": "- **API URL**: Exposed to client via `customFields`."
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 18,
        "snippet": "```ts"
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 18,
        "line_end": 19,
        "snippet": "```"
      },
      {
        "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": 22,
        "snippet": "- **AuthBar**: A custom navbar item registered in `textbook/src/theme/NavbarItem` (if swizzled) or i"
      },
      {
        "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": 23,
        "snippet": "- **Preset**: `classic` (standard docs, blog, pages)."
      },
      {
        "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": 26,
        "snippet": "- **Sidebar**: Defined in `textbook/sidebars.ts`."
      },
      {
        "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": 27,
        "snippet": "- **Custom CSS**: `textbook/src/css/custom.css` (contains specific overrides for dark mode and premi"
      },
      {
        "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": "- **Layout**: `Layout` wrapper is often used in `src/pages` for standalone React pages within Docusa"
      },
      {
        "id": "network:SKILL.md:16:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',"
      },
      {
        "id": "network:SKILL.md:16:hardcoded-ip-address",
        "category": "network",
        "severity": "medium",
        "pattern": "Hardcoded IP address",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',"
      },
      {
        "id": "env_access:SKILL.md:16:environment-variable-access-dot-notation",
        "category": "env_access",
        "severity": "low",
        "pattern": "Environment variable access (dot notation)",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',"
      },
      {
        "id": "env_access:SKILL.md:16:environment-variable-object",
        "category": "env_access",
        "severity": "low",
        "pattern": "Environment variable object",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',"
      },
      {
        "id": "sensitive:SKILL.md:16:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:9:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks delimit an inline Markdown file path. The line contains no executable shell or Ruby command."
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks delimit the Markdown term customFields. No command is invoked."
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the opening fence of a TypeScript example block, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is the closing fence of a TypeScript example block, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark documentation paths and a component name. The prose does not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark the Docusaurus preset name in Markdown. No execution syntax is present."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks delimit a referenced configuration file path. No command is invoked."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks delimit a CSS file path in documentation. This is not executable syntax."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark a component name and source directory in Markdown. No command execution occurs."
      },
      {
        "id": "network:SKILL.md:16:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The URL is a loopback development fallback in a Docusaurus configuration example. The skill does not make a network request."
      },
      {
        "id": "network:SKILL.md:16:hardcoded-ip-address",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "127.0.0.1 is a loopback address used only as a local development fallback. It does not target an external host."
      },
      {
        "id": "env_access:SKILL.md:16:environment-variable-access-dot-notation",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The example reads one named configuration variable to select an API URL. It does not access or transmit secrets."
      },
      {
        "id": "env_access:SKILL.md:16:environment-variable-object",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The detected process.env reference is limited to DOCUSAURUS_API_URL in a configuration example. No broad environment collection occurs."
      },
      {
        "id": "sensitive:SKILL.md:16:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line reads process.env and does not access an environment file. It only documents a named configuration variable."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 31,
    "audit_model": "claude",
    "audited_at": "2026-07-18T09:48:56.871Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Configure Advanced Docusaurus Documentation",
    "value_statement": "Docusaurus projects need consistent configuration across content, navigation, themes, and integrations. This skill explains the relevant files and configuration concepts for planning focused changes.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Docusaurus configuration",
      "Docusaurus plugins",
      "Docusaurus themes",
      "MDX documentation",
      "TypeScript docs",
      "documentation site"
    ],
    "actual_capabilities": [
      "Identifies the primary Docusaurus configuration file.",
      "Explains customFields for client-exposed configuration values.",
      "Describes the classic preset and sidebar configuration.",
      "Guides theme swizzling, custom CSS, and standalone layouts.",
      "Explains MDX support for interactive documentation components."
    ],
    "limitations": [
      "Does not modify files or run Docusaurus commands.",
      "Does not provide a complete Docusaurus project template.",
      "Does not validate configuration against a running site.",
      "Does not cover authentication implementation details."
    ],
    "use_cases": [
      {
        "title": "Plan documentation site settings",
        "description": "Map configuration, navigation, and theme changes before editing a Docusaurus project.",
        "target_user": "Documentation maintainer"
      },
      {
        "title": "Review a custom integration",
        "description": "Understand how an API URL can be exposed through Docusaurus custom fields.",
        "target_user": "Frontend developer"
      },
      {
        "title": "Prepare a theme update",
        "description": "Locate the areas for swizzled components, custom CSS, and page layouts.",
        "target_user": "Design engineer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Locate configuration",
        "scenario": "Beginner",
        "prompt": "Show me which Docusaurus files I should review before changing the site title and navigation."
      },
      {
        "title": "Explain custom fields",
        "scenario": "Intermediate",
        "prompt": "Explain how to configure a public API URL with Docusaurus customFields and identify security considerations."
      },
      {
        "title": "Plan a theme change",
        "scenario": "Advanced",
        "prompt": "Create a step-by-step plan to add custom CSS and a swizzled navbar item to this Docusaurus site."
      },
      {
        "title": "Review documentation architecture",
        "scenario": "Expert",
        "prompt": "Review this Docusaurus project structure and recommend a maintainable approach for sidebars, MDX components, and standalone pages."
      }
    ],
    "output_examples": [
      {
        "input": "Where should I change the documentation sidebar?",
        "output": [
          "Review the Docusaurus sidebar configuration file.",
          "Confirm the intended document hierarchy before changing item order."
        ]
      },
      {
        "input": "How can I expose a public API endpoint to documentation components?",
        "output": [
          "Use a Docusaurus custom field for a non-secret public URL.",
          "Use an environment variable for deployment-specific values.",
          "Do not place credentials or private endpoints in client-exposed fields."
        ]
      }
    ],
    "best_practices": [
      "Keep custom fields limited to values that are safe for browser clients.",
      "Use environment variables for deployment-specific public endpoints.",
      "Test theme and sidebar changes in a local Docusaurus build."
    ],
    "anti_patterns": [
      "Do not store secrets in customFields because browsers can read them.",
      "Do not edit generated site output instead of source configuration.",
      "Do not change several theme areas without checking mobile and dark mode views."
    ],
    "faq": [
      {
        "question": "What does this skill cover?",
        "answer": "It covers Docusaurus configuration, custom fields, presets, sidebars, themes, layouts, and MDX."
      },
      {
        "question": "Does this skill run Docusaurus?",
        "answer": "No. It provides guidance and does not run commands or modify files."
      },
      {
        "question": "Are customFields private?",
        "answer": "No. Values in customFields can be exposed to browser clients and must not contain secrets."
      },
      {
        "question": "Where are sidebars configured?",
        "answer": "The skill identifies the project sidebar configuration as the place to define documentation navigation."
      },
      {
        "question": "Can it help with theme changes?",
        "answer": "Yes. It explains custom CSS, swizzled components, and layout wrappers."
      },
      {
        "question": "Does it create MDX components?",
        "answer": "No. It explains that MDX supports interactive components but does not generate a component library."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 31
    }
  ]
}
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