skills README

项目的 README,来自 github.com/juliobsz/skills。合并为一个 markdown 文件:README.md。

/awwwards

An agent skill that builds award-caliber websites from one line.

Claude Code skill Antigravity supported Codex supported Agent Skills compatible MIT license Node 22.20 or later CI

Install with npx skills add

Demo · Install · Usage · How it works · Limits · /jury

> make me a portfolio, my name is Julio

That's the whole brief. The agent works as creative director, designer and creative developer in one, then hands back a site it has already checked in a real browser.

Quick start

npx skills add wheresryan22/anatomy -g   # optional: interactive isometric explainer figures
npx skills add juliobsz/skills -g

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

The same repo has /jury, which scores any site the way an Awwwards jury would: yours, one /awwwards built, or a competitor's.

Demo

Watch the demo on YouTube

Click on the thumbnail to watch the demo on YouTube

Install

Install with the skills CLI. It runs through npx, so there's nothing to install first, and it detects your agents (Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Copilot and more) and lets you pick.

npx skills add juliobsz/skills -g
Command Result
npx skills add juliobsz/skills -g -a claude-code Claude Code only (use codex, cursor… for others)
npx skills add juliobsz/skills This project only, instead of your user folder
npx skills add juliobsz/skills -g --skill jury One skill only (awwwards or jury)
npx skills add juliobsz/skills -g --copy Copy the files instead of linking them
npx skills update -g Update to the latest version
npx skills remove awwwards jury -g Uninstall

The CLI collects anonymous usage data. Set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 to turn it off.

Claude Code plugin

If you prefer Claude Code's plugin system, which updates the skill for you:

/plugin install awwwards --marketplace juliobsz/skills
/plugin install jury --marketplace juliobsz/skills

On Claude Code before 2.1.275, run /plugin marketplace add juliobsz/skills and then /plugin install awwwards@juliobsz (or jury@juliobsz). The skills then run as /awwwards:awwwards and /jury:jury. Use the plugin or the skills CLI, not both, or each skill shows up twice.

Google Antigravity (CLI, IDE & 2.0)

For Google Antigravity across all surfaces (CLI agy, Antigravity IDE, Antigravity 2.0):

  • Workspace: If working inside this repository, .agents/skills.json automatically registers awwwards and jury. In your own project, copy them into your .agents/skills/ directory:
    mkdir -p .agents/skills
    cp -r <path-to-repo>/awwwards <path-to-repo>/jury .agents/skills/
    
  • Global: Copy or link the folders to your global Antigravity skills directory:
    mkdir -p ~/.gemini/config/skills
    cp -r awwwards jury ~/.gemini/config/skills/
    

Start agy, open Antigravity IDE, or launch Antigravity 2.0 Desktop and trigger the skills via /awwwards or /jury.

Manual install

Copy the awwwards/ folder (and jury/, if you want it) into your agent's skills directory, for example ~/.claude/skills/awwwards, ~/.gemini/config/skills/awwwards or .agents/skills/awwwards. Any agent that reads SKILL.md skills can use them. Each folder works on its own.

Works with /anatomy

/anatomy by wheresryan22 is an open-source skill for detailed, interactive isometric figures that explain an idea as a real physical object. Install it next to /awwwards and the site can get one "how it works" section built as a real explainer figure, styled to the site's palette and grid.

npx skills add wheresryan22/anatomy -g

It's optional. Without it, /awwwards builds that section another way, and tells you at the end when a figure would have helped.

Requirements

Troubleshooting
  • /awwwards or /jury isn't found. Start a new session; agents read their skills folder at startup. Then run npx skills list -g to see where it was installed.
  • It shows up twice. You installed it two ways (for example the skills CLI and the plugin). Remove one with npx skills remove awwwards -g or /plugin uninstall awwwards@juliobsz.
  • Installed into the wrong agent. Name the target with -a, for example -a codex.
  • Screenshots fail with "Playwright not found". Run npm i -D playwright in the site's project. If it reports no Chromium, run npx playwright install chromium once.

Why

Ask an agent for "a portfolio" and you get the same site everyone gets: purple gradient, three cards, "elevate your brand". This skill replaces that default with a process.

Its quality bar is the work that wins Awwwards Site of the Day. The site doesn't need to be submitted anywhere; it just has to be that good.

Usage

Ask in one line and let the agent decide. It writes its assumptions down instead of running a questionnaire.

make me a portfolio, my name is Ana
a site for my architecture studio in Lisbon, we do small houses
launch page for a mechanical keyboard called Kestrel, it should feel insane
redesign this landing page so it could win site of the day

Better input gives a better site. Your real name, what you do, where you are and two or three real projects let the concept come from your story instead of a placeholder.

How it works

Phase What happens
Brief Infers who it's for, the audience and the site's job. Missing facts become written assumptions
Concept Three concepts from different territories (your name, your craft's materials, your place, how you work, a formal system), scored on originality and fit. The winner becomes a one-line idea with a signature moment
Art direction Palette by role, type pairing from a curated free-font library, grid, rhythm and motion language, all written to DESIGN.md. Then a "genericness test" kills anything an average model would have produced
Build Semantic HTML that looks finished with motion off. Then reveals, page transitions, a loader that tracks real loading, and the signature moment
QA loop Production build, a crawling audit (SEO, metadata, accessibility, weight, placeholder copy, AI-copy tells) and real-browser screenshots on desktop, mobile, reduced motion and mid-transition. It also measures LCP and CLS on a throttled phone, runs axe and tabs through every page. The agent reads every frame, a fresh critic subagent that never saw the plan scores the site against the rubric, and the agent fixes things until every category hits 8/10
Ship OG image, favicon, sitemap, robots, then deploy to Vercel, Netlify or Cloudflare (only after you confirm)

Stack

All three use GSAP (every plugin is free now), Lenis for smooth scroll and OGL for WebGL. The motion engine is framework-agnostic TypeScript, shipped as documented code instead of a template: it runs on one clock, reverts every effect on navigation, runs transitions in parallel with the next page loading, and keeps content visible without JavaScript or with reduced motion.

Principles it won't break

Limits

/jury

Scores any website the way an Awwwards jury would. It doesn't have to be a site /awwwards built.

/jury https://your-site.com
/jury score this project
/jury https://mine.com vs https://theirs.com

It shoots one page of every type on desktop, on a throttled phone, with reduced motion and from the keyboard. It measures LCP, CLS, FPS, axe and hover feedback, and audits SEO and metadata. Then a fresh critic that never sees the code, the design notes or your pitch scores Design, Usability, Creativity and Content, plus the six developer areas. Every number cites a screenshot or a measurement, and the fixes come ranked by how much score they'd gain.

You get .jury/<host>/scorecard.md, next to every screenshot and report behind it. Given a local project, it builds and scores the production output, never the dev server. Re-scoring after fixes uses a new critic, so it never anchors on the old numbers.

Checked against real juries. Run blind on two October 2026 Sites of the Day, the critic scored 6.15 and 6.10 where the jury gave 7.28 and 7.24: stricter, by a steady 1.1. So the card shows the critic's score and a jury estimate, and the band comes from the estimate. The critic is hardest on what juries rarely check (accessibility, SEO, performance on a throttled phone), which is why its fix list catches things a jury lets slide.

/awwwards runs the same rubric, scripts and blind critic in its own QA loop, so a site it built and a site you built are judged the same way.

Standalone scripts

The helpers work on any site, so you can use them on their own. The QA scripts live in jury/scripts/, and /awwwards carries a copy:

# Path depends on your agent (e.g. ~/.gemini/config/skills/ or ~/.claude/skills/)
node <skill-path>/jury/scripts/audit.mjs https://your-site.com/
node <skill-path>/jury/scripts/shoot.mjs https://your-site.com/ --crawl --nav
Script In Does
audit.mjs jury, awwwards Crawl a build: SEO, a11y, weight, placeholders, AI-copy tells
shoot.mjs jury, awwwards Screenshots of every page type: LCP/CLS on a throttled phone, FPS, overflow, tap targets, axe, keyboard focus, rest/hover pairs per pointer target, idle motion, transitions (needs Playwright; axe-core optional)
serve.mjs jury, awwwards Static server for build output
og.mjs awwwards Render the OG image from the live hero (needs Playwright)
font.mjs awwwards Self-host Fontshare / Google fonts (CSS or next/font output)
photos.mjs awwwards Contact sheets of free photos for marked placeholders
Repository layout
awwwards/
  SKILL.md            the workflow and the hard rules
  references/
    quality-bar.md    scoring weights, rubric, critic brief  (copied from jury/)
    concepts.md       finding an idea that can't be moved to someone else
    art-direction.md  patterns from recent winners, archetypes, AI defaults to avoid
    typography.md     curated free fonts with sources, scales, setting display type
    layout.md         grids, section families, heroes, mobile composition
    motion.md         choreography and recipes (loader handoff, iris, shared element, index preview…)
    webgl.md          DOM-synced image planes, fullscreen shaders, performance rules  (generated)
    patterns.md       proven structures from test builds (driver module, sticky stage…)
    content.md        voice, honest placeholders, case-study structure
    quality.md        accessibility, performance budgets, bugs found in real builds
    engine.md         framework-agnostic motion engine          (generated)
    nextjs.md         Next.js adapter, layout, metadata, fonts  (generated)
    astro.md          Astro adapter and layout                  (generated)
    ship.md           final checks and deploy
  scripts/            Node helpers; shoot, audit, browser and serve are copied from jury/
jury/
  SKILL.md            the review workflow: target, evidence, blind critic, score card
  references/
    quality-bar.md    scoring weights, rubric, critic brief
    calibration.md    the critic against real juries, for the score card (never shown to the critic)
  scripts/            shoot, audit, browser, serve: no dependencies except Playwright (and axe-core)
tests/
  nexttest/           Next.js app the generated references are copied from
  astrotest/          Astro app, same engine
  _gen/               templates and build.py that write the generated references and copies
  smoke.mjs           browser smoke test run against both fixtures in CI
.claude-plugin/       Claude Code plugin marketplace
.github/              CI workflow, issue and PR templates

Security

A skill is instructions your agent follows, and these have it run builds and scripts on your machine. Read each SKILL.md before installing, as you would any code you run. Nothing is deployed without your confirmation.

Contributing

Issues and pull requests are welcome, especially for bugs found in real builds and new patterns in awwwards/references/.

  1. Fork the repo and create a branch.
  2. Make the change. A skill is a folder with a SKILL.md; the skills CLI finds any top-level folder that has one. For the Claude Code plugin, also add an entry to .claude-plugin/marketplace.json. Engine and stack code lives in tests/nexttest and tests/astrotest, not in the markdown: edit it there and run python tests/_gen/build.py (see tests/README.md). The QA scripts and the rubric live in jury/, and the same command copies them into awwwards/, so edit them in jury/.
  3. Test it: npx skills add . -g -a claude-code, then run the skill in an agent.
  4. Open a pull request. The template asks what changed and what you built to check it; CI checks script syntax, SKILL.md frontmatter, the plugin marketplace and that the skills CLI finds every skill, on Linux, macOS and Windows. It also builds and smoke-tests both fixture apps and fails if the generated references or copies are out of date.

Support

Found a bug or have an idea? Open an issue.

License

MIT © juliobsz

skills (juliobsz/skills)

正在搜索数据库…

1.3K ·GitHub
这是什么?这是一个名为 /awwwards 的智能体技能,能把一句话的需求变成达到获奖水准的网站。智能体会同时扮演创意总监、设计师和开发者,最后交付一个已在真实浏览器中检查过的网站。
这是我要运行的应用,还是要添加到编程助手里的东西?这是一个安装到 AI 编程助手(Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Copilot、Google Antigravity)中的智能体技能,在会话中通过 /awwwards 或 /jury 触发,而不是独立的应用程序。
运行之前需要先安装什么?需要 Node 22.20+ 用于命令行工具(辅助脚本需要 20+),以及 Playwright 和 axe-core。这两者由 /awwwards 自动作为开发依赖安装,用于截图和无障碍检查。质量检查循环还需要一个能够读取图片的模型。
这是快速的代码片段,还是一个漫长的流程?完整运行速度较慢,且非常消耗 token。它会经历构思、设计系统、构建,以及多轮截图和修复。结果的质量在很大程度上取决于运行它的模型。
安装程序会追踪我的任何信息吗?skills 命令行工具默认会收集匿名使用数据。你可以设置 DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1 来关闭此功能。
/jury 是什么?这是一个配套技能,它以 Awwwards 评审团的方式为任何网站打分。它使用一个从未见过方案的全新评审员,依据实测截图,对设计、可用性、创意、内容以及六个开发者维度进行评分。
它用什么技术栈构建网站?默认使用 Next.js(App Router);纯内容展示类的站点使用 Astro;如果在现有项目中运行,则沿用你已有的技术栈。在值得的地方,会使用 GSAP、Lenis 和 OGL(WebGL)来实现动效。
它会自动部署我的网站吗?不会。只有在你明确确认之后,才会部署到 Vercel、Netlify 或 Cloudflare。没有经过这种确认,任何内容都不会上线。
它会用虚假的占位内容填充网站吗?不会。不允许使用 Lorem ipsum、虚构的奖项或编造的数据指标。智能体凡是临时编造的内容,都会明确标注为占位符,并在末尾列出,供你替换。
作者
juliobsz
大小
1.1 MB
星标
1.3K
更新
提交Oct 26
时长
1个月
提交 · 90 天