Skip to content

Repository files navigation

Skills

Reusable agent skills for engineering, interface design, code reviews, and agent workflows. Each folder in skills/ is independently installable and includes its supporting references, scripts, and assets.

Install

Use the Skills CLI to choose skills and agents:

npx skills add sadjow/skills

List available skills, install one in a project, or install globally:

npx skills add sadjow/skills --list
npx skills add sadjow/skills --skill web-ui-design
npx skills add sadjow/skills --skill web-ui-design -g -a codex

The installer uses npm to run the existing CLI. This collection does not require a separately published npm package. You can also copy an individual skill folder into your agent's skill directory. Reload the agent if needed for discovery.

Collection

UI and product design

Frameworks, testing, and performance

Reviews and communication

Agent workflows and operations

The focused interaction and LiveView skills can be installed separately from the broader design and framework skills. Choose the narrowest workflow that fits the task; installing every overlapping skill is optional.

Choosing a skill

Task Start with Add when needed
General web interface work web-ui-design expressive-ui-design for visual craft; accessible-web-interactions for interaction accessibility
Context-free usability review with persona agents cold-ux-review web-ui-design for the heuristic pass; accessible-web-interactions for the accessibility guard
Manual list ordering or drag and drop reorderable-list-ux web-interaction-resilience for save timing and conflicts; phoenix-liveview-interaction-resilience for LiveView patches and focus
LiveView UI implementation phoenix-ui-architecture phoenix-liveview-interaction-resilience for timing, forms, uploads, recovery, and its reconnect helper
LiveView flicker, late state, stutter, or slow mount phoenix-liveview-perceived-performance diagnose-web-performance for framework-neutral measurement; phoenix-liveview-interaction-resilience when input is lost or duplicated
Slow or unsteady web journey in any stack diagnose-web-performance playwright-reactive-ux-testing for temporal regressions; a framework specialist once the layer is known
Reactive UI testing playwright-reactive-ux-testing playwright-responsive-ui-testing for the bundled viewport and capture starter kit
Responsive layout testing playwright-responsive-ui-testing playwright-reactive-ux-testing when a failure depends on event ordering or recovery
Pull-request review review-pr-collaboratively leave-code-review-comments-collaboratively when turning findings into approved comments
Before/after UI screenshots or scrolling video ui-comparison-evidence github-media-attachments for uploads; flutter-text-scaling-accessibility for Flutter scaling checks
Agent harness maintenance improve-project-agent-harness evolve-agent-harness when retaining a lesson from concrete feedback
Create or refine one skill skill-creator agent-skill-content-research for domain knowledge gaps
Audit or upgrade a collection upgrade-agent-skills Fresh official research is part of every audit

The organization notes explain the layout and link to the current specification and installer documentation.

The rename map records retired identifiers and their current replacements. See the upgrade review for scope changes, research, and migration guidance. Install the replacement before removing an old installation; preserve any local customizations.

Prerequisites

Markdown-only skills need no runtime. Executable helpers describe their own requirements: Python 3 for review and complexity tools, Git and GitHub CLI for GitHub operations, tmux for service management, and ffmpeg/ffprobe for frame extraction. Browser and API workflows need the relevant configured tools and user-provided authentication. Installing a skill does not install those tools or authorize an external action.

Upstream skills and customized dependencies retain their own sources and licenses. Plugin-bundled skills remain installed through their plugins.

Home Manager

Consume a pinned repository revision without running npm during activation:

inputs.skills = {
  url = "github:sadjow/skills";
  flake = false;
};

Pass the input to your Home Manager module and use home.file.".agents/skills/web-ui-design".source = "${skills}/skills/web-ui-design";. Other agents can consume the same source. Update the skills input in the consumer's lockfile when adopting changes. Edit this repository, not read-only installed files in the Nix store.

Contributing

See contribution instructions. Run npm ci and npm run check for metadata, packaged resources, syntax, validator tests, and TypeScript assets. Node.js 22 and Python 3 are tested in CI. The package manifest is private to prevent accidental npm publication; GitHub is the distribution source.

The resilient UI instruction block can be adapted into a project's own instructions. Keep project-specific details there.

License

Original content is MIT licensed. Customized third-party content keeps its upstream license and notices; see provenance.

About

Reusable agent skills for engineering, UI design, reviews, and agent workflows

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages