Repolode
Submit
juliobsz

juliobsz/skills

An agent skill that makes AI coding agents build designed, award-style websites from a one-line brief, plus a companion /jury skill that scores sites.

View on GitHub
Stars
738
Forks
26
Open issues
0
Last commit
13 hours ago

What is it?

awwwards is a skill for coding agents such as Claude Code, Codex and Antigravity. Given a short brief like "make me a portfolio, my name is Julio", it works through concept, art direction, build and QA, aiming to avoid the generic template look most AI-generated sites have. It writes a design system to DESIGN.md, chooses a concept and a signature motion moment, and builds with Next.js or Astro using GSAP, Lenis and OGL for motion and WebGL.

Before handing back a site, the skill runs a production build, a crawling audit covering SEO, accessibility and placeholder copy, and takes real-browser screenshots on desktop, mobile and reduced-motion settings. It measures LCP and CLS on a throttled phone and runs axe checks, then iterates until its rubric scores are met. Placeholders for missing content are clearly marked. Deployment to Vercel, Netlify or Cloudflare happens only after the user confirms.

The repository also includes /jury, a separate skill that scores any website on design, usability, creativity and content, along with developer-facing checks, and returns a ranked list of fixes. Standalone QA scripts for auditing and screenshotting are included as well.

Key features

  • 01Turns a one-line brief into a concept, design system and finished site
  • 02Writes palette, type, grid and motion rules to DESIGN.md
  • 03Builds with Next.js (App Router) or Astro, using GSAP, Lenis and OGL
  • 04Checks output with production builds, crawl audits, axe and real-browser screenshots
  • 05Includes /jury to score any website and rank fixes by expected gain

Use cases

  • Generating a personal portfolio or studio site from a short description with an AI coding agent
  • Redesigning an existing landing page for stronger visual impact
  • Auditing a site's SEO, accessibility and performance with the jury scripts
  • Benchmarking a competitor's website against a structured design rubric

Quick start

  1. 1

    Install the awwwards skill globally with the skills CLI

    npx skills add juliobsz/skills -g
  2. 2

    Open a new agent session, then ask for a website or type /awwwards

Things to know

  • A full run takes a long session and heavy token use.
  • Results depend on the underlying model's ability to judge its own screenshots.
  • Sites ship with placeholder content that you must replace with real projects and copy.
  • The /jury scoring is an unaffiliated estimate validated on only two sites.

Topics

#agent-skills#claude-code#web-design#frontend#gsap#webgl#nextjs#astro#awwwards#claude-skills

FAQ

What is skills?
An agent skill that makes AI coding agents build designed, award-style websites from a one-line brief, plus a companion /jury skill that scores sites. awwwards is a skill for coding agents such as Claude Code, Codex and Antigravity. Given a short brief like "make me a portfolio, my name is Julio", it works through concept, art direction, build and QA, aiming to avoid the generic template look most AI-generated sites have. It writes a design system to DESIGN.md, chooses a concept and a signature motion moment, and builds with Next.js or Astro using GSAP, Lenis and OGL for motion and WebGL.
Is skills free to use? What license does it have?
skills is open source under the MIT license. Check the license terms before using it in commercial products.
Is skills still maintained?
Actively maintained. The last commit to skills was on Oct 20, 2026.
What can I use skills for?
Generating a personal portfolio or studio site from a short description with an AI coding agent Redesigning an existing landing page for stronger visual impact Auditing a site's SEO, accessibility and performance with the jury scripts Benchmarking a competitor's website against a structured design rubric
How do I install skills?
Install the awwwards skill globally with the skills CLI: npx skills add juliobsz/skills -g Open a new agent session, then ask for a website or type /awwwards
Where can I get skills?
The source code and installation instructions are on GitHub: https://github.com/juliobsz/skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects