Agent Skills (AsyrafHussin)

Agent Skills

24 скилла для Laravel, PHP, React и TypeScript: правила кода, тесты, безопасность, технический долг и документация.

  • 103 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Наборы содержат инструкции и правила для агента, собственных программ они не запускают.
Все причины и проверки

asyrafhussin/agent-skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/asyrafhussin-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Наборы содержат инструкции и правила для агента, собственных программ они не запускают.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий собирает 24 скилла по спецификации Agent Skills. Они закрывают Laravel 13 (архитектура, очереди, тесты на Pest и PHPUnit, оптимизация базы, аудит OWASP), современный PHP 8, React с Vite, TypeScript, Tailwind, TanStack Query и Zustand, проектирование REST API, Git, SEO и доступность. В каждом скилле лежат `SKILL.md`, `AGENTS.md`, папка `rules/` с правилами и `metadata.json`. Часть скиллов работает как аудит: `technical-debt` ранжирует долг по шкале P0–P3, `code-slop` выносит дифу вердикт CLEAN, SUSPICIOUS, INFLATED или CRITICAL, а `web-design-guidelines` отдает чек-лист PASS и FAIL по доступности.

Для кого. Разработчикам на Laravel, PHP, React и TypeScript, которым нужны готовые правила и аудиты для Claude Code, Cursor и Codex.

Подходит, если

  • Ревью контроллера Laravel на соответствие правилам и OWASP.
  • Перед рефакторингом нужен ранжированный список технического долга.
  • Pull request, написанный с помощью ИИ, проверяют на повествовательные комментарии, общие имена и лишние интерфейсы.
  • Пишутся тесты фичи на Pest, и агенту нужны подсказки по фабрикам и подменам фасадов.

Не подходит, если

  • Стек другой, например Django или Spring: правила рассчитаны на PHP, Laravel и Node с TypeScript и React.
  • Нужен автоматический линтер: скиллы направляют агента и не заменяют PHPStan или ESLint.
  • Требуется один узкий навык: ставьте его по имени через флаг `--skill`, весь набор ни к чему.

Пример запроса к агенту

Проверь технический долг в этом проекте и скажи, что рефакторить первым.

Ограничения

Правила привязаны к версиям: Laravel 13, Pest 4, PHPUnit 12, Tailwind 3.4 и 4, TanStack Query 5, Zustand 5. Для других версий они могут устареть. Команда `npx skills add` копирует файлы в `.claude/skills/`, а с флагом `-g` в `~/.claude/skills/`. Подстройка под другие стеки не предусмотрена. Скиллы описывают приемы и правила, а запускать проверки агент будет собственными средствами проекта: тестами, линтерами и сборкой.

Как отключить. Выполните `npx skills remove` и выберите скиллы либо удалите их папки из `.claude/skills/` или `~/.claude/skills/`.

Частые вопросы

Как поставить один скилл, а не весь набор?

Добавьте флаг `--skill`, например `npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices`. Флаг можно повторять для нескольких скиллов.

Чем technical-debt отличается от code-slop?

`technical-debt` считает метрики (сложность, дублирование, уязвимости, индексы базы) и ранжирует работу. `code-slop` оценивает вкус кода в дифе: названия, комментарии, лишние абстракции. Для полного аудита запускают оба.

Как посмотреть список скиллов без установки?

Выполните `npx skills add AsyrafHussin/agent-skills --list`.

С какими агентами работает набор?

С Claude Code, Cursor, Codex и еще более чем 70 агентами из списка проекта vercel-labs/skills. Конкретного агента задают флагом `-a`, например `-a claude-code`.

Что входит в каждый скилл набора?

Файл `SKILL.md`, `AGENTS.md`, папка `rules/` с отдельными правилами и `metadata.json`. Скиллы описывают категории правил: например, у `laravel-testing` их 24 в шести категориях.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

15 скиллов для Claude Code и Codex: Laravel, Docker, UI, отладка, тесты и документация в четырех готовых плагин-пакетах

ПлагинРасширенный доступ69Звезды репозитория

Набор скиллов против ИИ-халтуры: аудит интерфейса и типографики, ревью изменений, релизы, документация и SEO.

СкиллРасширенный доступ199Звезды репозитория

Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету

СкиллРасширенный доступ7,2 тыс.Звезды репозитория

Brooklyn skills — 25 переносимых скиллов для агентов: ведение pull request, триаж, чистка кода, проверка интерфейса и исследования

СкиллРасширенный доступ215Звезды репозитория

Библиотека скиллов для Claude Code, Cursor и Codex: ревью командой агентов, TDD, стековые PR, оценка готовности репозитория

ПлагинРасширенный доступ72Звезды репозитория

Набор независимых скиллов против дрейфа в больших кодовых базах: hard-cut, поиск первопричины, тесты и проверка CI.

СкиллМинимальный доступ140Звезды репозитория

Коротко о README

Скиллы соответствуют спецификации Agent Skills, их каталог ведется на skills.sh. Установка идет через `npx skills`, вручную копированием папок или с флагом `-g` для всех проектов. Для каждого скилла в README есть пример запроса.

Бейдж для README

Исходный SKILL.md

---
name: code-slop
description: Detect AI-generated code patterns ("slop") in PHP/Laravel and TypeScript/React source — comment narration, generic naming, premature interfaces, defensive overdose, mock-everything tests, and the absence of human "scars". Use when reviewing AI-assisted PRs, auditing code for taste/quality (not metrics — that's technical-debt), or hardening a code-review checklist. Triggers on "review for AI slop", "find AI patterns", "check code feels human", "audit code-quality taste".
license: MIT
metadata:
  author: agent-skills
  version: "1.0.0"
---

# Code Slop Detection

Taste-level review of code for AI-generated patterns. Contains 24 rules across 6 categories covering comments, naming, over-engineering, defensive overdose, test slop, and style fingerprints. Where [`technical-debt`](../technical-debt) measures *quantitative* code debt (complexity, duplication, CVEs), this skill measures the *qualitative* failure mode: code that passes every metric but reads like a tutorial blog post, not like a human wrote it.

## Metadata

- **Version:** 1.0.0
- **Scope:** PHP / Laravel + TypeScript / React (Node)
- **Rule Count:** 24 rules across 6 categories
- **License:** MIT

## Why this skill exists

Industry data on AI-assisted code (GitClear 2025, cURL bug-bounty shutdown 2025, arXiv 2510.03029):

- **Refactoring collapsed** from 25% to <10% of changes
- **Copy-paste surged** 8.3% → 12.3%; code duplication rose ~8x
- **Code-smell rates +42–85%** over human baselines
- **82% of AI PRs** use generic catch blocks that don't distinguish error types
- **76% miss timeouts** on external calls

None of this fails a typical CI lint. It just makes the codebase slowly unmaintainable. This skill is the lens for catching it before it ships.

The core insight: **reading cost > writing cost now**. The cost of writing code collapsed; the cost of reading it didn't. Code you can't quickly understand is slop, even if it works.

## How to Audit

When the user asks "review for AI slop", "audit code-quality taste", or "find AI patterns" — run through this skill's rules as a checklist against the changed files (PR diff) or full repo.

### Audit Step 1: Determine Scope

- If a PR diff is provided: audit only files changed in the diff
- If files are named: audit those
- If no scope: audit the whole repo, prioritized by recently-touched files (most likely AI output)

### Audit Step 2: Detect Stack

Сообщить о проблеме