feat: launch adeptability.itaywol.tools website with Astro + Starlight docs#52
Merged
Conversation
…t docs Replace the mkdocs GitHub Pages site with a single Astro project under site/: a custom-designed landing page (hero fan-out, install cards, how-it-works, demo gifs) and all documentation migrated to Starlight under /docs with the mkdocs nav preserved. - Deploy via Cloudflare Workers static assets (wrangler), custom domain adeptability.itaywol.tools, mirroring the testless site setup. - Reduce .github/workflows/docs.yml to a GitHub Pages redirect so old itaywol.github.io/adeptability links keep resolving. - Add three reproducible vhs tapes (assets/tapes/) and regenerate assets/demo.gif plus new authoring.gif and agents.gif, themed to the site palette. - Point README docs links at the new domain.
…nd aspect - Vectorize the brand mark (open hexagon + sparkle) from logo.png via potrace; ship assets/logo-mark.svg with a warm gold radial glow that stays legible on GitHub light and dark backgrounds. - Use the mark (not the white-background lockup) as the README logo, the site favicon (favicon.svg), the Starlight logo, and the landing header/footer marks. - Regenerate all demo gifs without the vhs-baked window bar and margins (the site supplies its own window chrome) at a uniform 1520x856, the exact 2x of the landing slots, removing the aspect-ratio squish.
- Rework the logo glow to a neon gold outline (blurred wide stroke under a crisp gold-gradient stroke) across README mark, favicon, Starlight logo, and the landing header/footer marks; no more radial halo. - Retheme all site accents from teal/iris to a gold gradient family (#ffd77a / #f6c667 / #e0a43b) on landing and Starlight docs (both color schemes); fan-out diagram goes gold monochrome with a lightness ramp per harness node. - Add SEO/AEO foundations: robots.txt with AI crawlers explicitly allowed, spec-compliant llms.txt plus llms-full.txt regenerated by a prebuild script, SoftwareApplication JSON-LD on the landing page, and og:image/twitter:image on every docs page. - Remove em dashes from site copy and metadata; fix whitespace collapse around inline elements in landing prose.
Add three missing docs sections, all grounded in CLI help output, source, and live command runs: - guides/installing-skills: skill search / info / install / update / check, the owner/repo/skill slug, SHA locking, and how the safety scan gates installs. - reference/configuration: every config key with type, default, and effect, config llm providers, scope behavior, on-disk location. - guides/automation-json: the global --json flag with verified payload shapes, jq examples, exit codes for CI gating, and the drift hook. Also document shell completions on the install page and agent scaffold templates in the agents concept. Sidebar and llms.txt manifest updated.
Remove the legacy docs/ markdown mirror (left behind by the mkdocs to Starlight migration). Documentation now lives only under site/src/content/docs/ and publishes to adeptability.itaywol.tools. docs/superpowers/ design specs stay.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
New website at https://adeptability.itaywol.tools (live now), replacing the mkdocs GitHub Pages site.
site/— Astro 7 project: custom landing page (brand-derived design: navy/iris/spark palette, Space Grotesk + JetBrains Mono, animated SKILL.md→harness fan-out hero) + Starlight docs at/docswith all 21 pages migrated, mkdocs nav preserved.wrangler deploy), custom domain route — same setup as testless..github/workflows/docs.ymlnow deploys a path-preserving redirect on GitHub Pages so olditaywol.github.io/adeptability/*links keep working;mkdocs.ymlremoved.assets/tapes/), realadeptoutput, themed to the site:demo.gif(sync fan-out hero, refreshed in README),authoring.gif(skill add → drift → sync),agents.gif(subagent add + harness registry).Migration notes
<Tabs>;:material-*icons → emoji.docs/*.mdleft untouched in this PR (site copies live undersite/src/content/docs/) — follow-up can decide single-source.Verified
npm run buildgreen (23 pages), screenshot-reviewed landing + docs + tabs./,/docs/,/docs/harness-comparison/, gifs all 200.