From bd76b63b8ec0b1f4c896061e742c9406f31ca76d Mon Sep 17 00:00:00 2001 From: Paul Bakaus Date: Thu, 8 Jan 2026 09:08:40 -0800 Subject: [PATCH] Add FAQ section with accordion-style questions Covers: - Where to put downloaded files (project vs global) - Troubleshooting missing commands/skills - Getting started resources for beginners Co-Authored-By: Claude Opus 4.5 --- public/css/workflow.css | 116 ++++++++++++++++++++++++++++++++++++++++ public/index.html | 54 ++++++++++++++++++- 2 files changed, 169 insertions(+), 1 deletion(-) diff --git a/public/css/workflow.css b/public/css/workflow.css index 4de1a3d89..7e17eb64b 100644 --- a/public/css/workflow.css +++ b/public/css/workflow.css @@ -695,3 +695,119 @@ width: 100%; } } + +/* ============================================ + FAQ SECTION + ============================================ */ + +.faq-section { + position: relative; + padding: var(--spacing-xl) 0; + border-top: 1px solid var(--color-mist); +} + +.faq-list { + max-width: var(--width-content); + margin: var(--spacing-lg) auto 0; + display: flex; + flex-direction: column; + gap: 0; +} + +.faq-item { + border-bottom: 1px solid var(--color-mist); +} + +.faq-item:first-child { + border-top: 1px solid var(--color-mist); +} + +.faq-question { + font-family: var(--font-display); + font-size: 1.125rem; + font-weight: 500; + color: var(--color-ink); + padding: var(--spacing-md) 0; + cursor: pointer; + list-style: none; + display: flex; + align-items: center; + justify-content: space-between; + transition: color 0.2s ease; +} + +.faq-question::-webkit-details-marker { + display: none; +} + +.faq-question::after { + content: '+'; + font-family: var(--font-body); + font-size: 1.5rem; + font-weight: 300; + color: var(--color-accent); + transition: transform 0.3s var(--ease-out); +} + +.faq-item[open] .faq-question::after { + transform: rotate(45deg); +} + +.faq-question:hover { + color: var(--color-accent); +} + +.faq-answer { + padding: 0 0 var(--spacing-md); + color: var(--color-charcoal); + line-height: 1.7; + animation: faqFadeIn 0.3s var(--ease-out); +} + +.faq-answer p { + margin: 0 0 var(--spacing-sm); +} + +.faq-answer p:last-child { + margin-bottom: 0; +} + +.faq-answer ul { + margin: var(--spacing-sm) 0; + padding-left: var(--spacing-md); +} + +.faq-answer li { + margin-bottom: var(--spacing-xs); +} + +.faq-answer code { + font-family: var(--font-mono); + font-size: 0.875em; + background: var(--color-mist); + padding: 2px 6px; + border-radius: 3px; + color: var(--color-ink); +} + +.faq-answer a { + color: var(--color-accent); + text-decoration: none; + border-bottom: 1px solid transparent; + transition: border-color 0.2s ease; +} + +.faq-answer a:hover { + border-bottom-color: var(--color-accent); +} + +@keyframes faqFadeIn { + from { + opacity: 0; + transform: translateY(-8px); + } + to { + opacity: 1; + transform: translateY(0); + } +} diff --git a/public/index.html b/public/index.html index 33a8ca8e4..de7e95e92 100644 --- a/public/index.html +++ b/public/index.html @@ -418,7 +418,59 @@ - + +
+
+ 07 +

Frequently Asked Questions

+
+ +
+
+ Where do I put the downloaded files? +
+

Extract the ZIP to your project root (same level as your package.json or src/ folder). The files should create a hidden folder like .claude/, .cursor/, .gemini/, or .codex/.

+

Alternatively, you can install globally to your home directory:

+
    +
  • Claude Code: ~/.claude/
    • +
  • Cursor: ~/.cursor/
    • +
  • Gemini CLI: ~/.gemini/
    • +
  • Codex CLI: ~/.codex/
    • +
+

Project-level installation takes precedence and lets you version control your skills.

+
+
+ +
+ Commands or skills aren't appearing. What do I do? +
+

For commands: Type / in your AI tool and look for commands like /audit, /polish, etc. If they don't appear, double-check the files are in the correct location.

+

For skills: Skills are applied automatically when relevant. To verify, explicitly mention "use the frontend-design skill" in your prompt—this forces the AI to acknowledge and apply it.

+

Tool-specific setup:

+
    +
  • Cursor: Requires Nightly channel + Agent Skills enabled in Settings → Rules
    • +
  • Gemini CLI: Requires @google/gemini-cli@preview + Skills enabled via /settings
    • +
+
+
+ +
+ I'm new to AI coding tools. Where do I start? +
+

Skills and commands are intermediate features. If you're just getting started, learn the basics first:

+ +

Once you're comfortable with basic prompting and code generation, come back and install Impeccable to level up your design output.

+
+
+
+
+ +

Open Source