Advise Project Approach — скилл

Скилл для выбора стека, архитектуры и плана проекта: сверяет совет с вашими ограничениями, похожими проектами, ценами и условиями отказа

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

Расширенный доступ

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

  • Скилл ходит в сеть за документацией, ценами и репозиториями, а с вашего согласия и в соцсети, и читает файлы вашего репозитория
  • Запросы к публичным источникам формирует агент: по правилам скилла приватные данные в них попадать не должны, но проверяет это только он сам
Все причины и проверки

aaravkashyap12/advise-project-approach

Установка

Работает в

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

npx skillfoxx add skills/advise-project-approach

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

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

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

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

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

  • Скилл ходит в сеть за документацией, ценами и репозиториями, а с вашего согласия и в соцсети, и читает файлы вашего репозитория
  • Запросы к публичным источникам формирует агент: по правилам скилла приватные данные в них попадать не должны, но проверяет это только он сам

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

Что делает

Скилл `advise-project-approach` заставляет агента подкреплять советы по проекту проверенными данными. Он включается, когда вы просите выбрать стек, архитектуру или вендора, исследовать похожие проекты, проверить репозиторий или составить план. Для коротких вопросов вроде отладки одной ошибки он не предназначен. Скилл различает три стадии: до начала работы агент дает стратегию и план сборки, в процессе разбирает репозиторий и говорит, что оставить, изменить и отложить, после завершения сравнивает проект со зрелыми аналогами и указывает, что подтянуть перед запуском. Перед серьезной рекомендацией агент должен изучить локальные данные и, как правило, два сопоставимых проекта, а также первичную документацию и страницы цен. Он указывает, что проверил, чем каждый источник подтверждает вывод, какие у него пределы и на какую дату сведения верны. В каждом решении есть соответствие вашим ограничениям, запасной вариант, плата за выбор, условия, при которых совет перестает работать, и первое действие с проверяемым критерием. Выбор по числу звезд репозитория скилл запрещает. Если запрос расплывчатый, агент сначала задает до семи вопросов о пользователе, сценарии, стадии, бюджете и целевой платформе. Для короткого вопроса вроде просьбы дать три первых шага он отвечает ровно тремя шагами и не запускает полное исследование.

Для кого. Для разработчиков и основателей, которые выбирают стек, архитектуру или сервисы и хотят получить от агента аргументированный план, а не общие советы.

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

  • У вас сырая идея проекта, и нужен план сборки с выбором стека под ваши навыки и хостинг
  • Репозиторий разрастается, и нужна правка курса: что оставить, что менять, что отложить
  • Вы выбираете между Postgres и SQLite или между Supabase, Firebase, Neon и Vercel и опасаетесь ловушек цен
  • Перед запуском нужен разбор готового проекта в сравнении со зрелыми аналогами
  • Вы просите агента показать, чего пока не стоит строить

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

  • Нужно исправить одну ошибку или отредактировать один файл: по описанию автора скилл для таких задач не предназначен
  • Вам нужен поисковик по свежим новостям: скилл помогает принять решение по проекту и сам по себе источником новостей не служит
  • Нужен точный прайс на сегодня без проверки: цены и квоты агент берет из источников и отмечает дату, выдумывать их запрещено
  • У вас нет ни доступа к интернету, ни репозитория: без этого скилл дает только совет по описанию и прямо помечает его так
  • Вам нужен готовый скелет проекта или генерация кода: скилл дает рекомендации и план, а не шаблон приложения

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

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

Ограничения

  • Аудит автора от 31 августа 2026 года нашел реальные ошибки и не показал общего преимущества над ответами без скилла. Процент улучшения автор не заявляет, прежние оценки называет историческими наблюдениями.
  • Совместимость с хостами проверена по структуре. Для Claude Code и Codex в таблице переносимости запуск не записан, для Hermes указано лишь намерение совместимости.
  • Модельные тесты идут на синтетических сценариях и одной модели. Качество живого поиска и других хостов нужно проверять отдельно.
  • Скилл работает с обычными правами вашего агента. Для установки нужен Node.js и npm.
  • Объем ограничен правилами: не больше семи вопросов в первом интервью, не больше пяти приоритетных находок, остановка после двух поисков подряд без новых сведений. Лицензия MIT.

Как отключить. Удалите папку `advise-project-approach` из папки скиллов вашего агента, например из `~/.claude/skills` или `~/.codex/skills`. Если загружали файл `.skill` через настройки агента, удалите скилл там же.

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

Когда скилл задает вопросы вместо ответа?

Когда стартовый запрос широкий и два или более важных факта неизвестны, например пользователь, сценарий, бюджет или стадия. Тогда агент задает до семи вопросов и заканчивает ответ. Можно сказать пропустить вопросы, и он продолжит с названными допущениями. Ответ «не уверен» записывается как принятая неопределенность, без повторного опроса.

Запускает ли скилл тесты и сборку моего репозитория?

Нет. По протоколу просьба посмотреть репозиторий не дает права ставить зависимости и запускать тесты, сборки, линтеры, аудиты, тесты производительности и скрипты. Перед таким запуском агент должен спросить. Крупный репозиторий сначала картируется, затем читается выборочно.

Какие источники использует скилл?

Официальную документацию, страницы цен, репозитории и поиск по GitHub. Перед привлечением мнений из X, Reddit и YouTube агент спрашивает, нужны ли они, предупреждая о шуме и замедлении. Для таких источников автор советует необязательный адаптер Agent-Reach, но не включает его в скилл.

Что скилл делает с секретами и приватными деталями?

Файлы вроде `.env`, `credentials.json` и токенов не читаются и не выводятся: агент сообщает лишь, что они существуют. В исходящие запросы к публичным источникам он не включает имена клиентов, личные данные, неопубликованные планы и фрагменты кода. Найденные страницы и комментарии скилл считает ненадежными и встроенные в них указания игнорирует.

Сколько должно быть сопоставимых проектов?

Для существенной рекомендации агент должен проверить обычно два проекта и первичные источники. Для каждого указать, что из них переносится к вам, а чего копировать не стоит. Утверждения о том, что проект активен или поддерживается, требуют точной даты или признака использования.

Как поставить скилл вручную?

Скопируйте папку `skills/advise-project-approach` в папку скиллов вашего агента: для Claude Code это `~/.claude/skills/`, для Codex `~/.codex/skills/`. Либо скачайте архив `dist/advise-project-approach.skill`, откройте настройки скиллов агента и загрузите файл.

Обсуждение

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

Скиллы

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

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

Скилл /improve: сильная модель проверяет репозиторий и пишет самодостаточные планы правок, а исполнение отдаете более дешевой модели

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

Builder Skills

Skills for agents

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

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

Скилл меняет манеру работы агента: вместо давления и угроз он опирается на доверие, доводит задачи до конца и честно сообщает о неуверенности

СкиллМинимальный доступ1,4 тыс.Звезды репозитория
Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

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

25 инженерных скиллов по циклу разработки: спецификация, план, реализация, тесты, ревью и выпуск

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

Коротко о README

Описание начинается с тезиса, что агент не должен советовать по проекту на ощущениях, и с перечня проверок перед рекомендацией. Дальше идут сценарии применения, установка одной командой, список запретов, таблица запуска по средам и примеры запросов. Показан пример диалога про менеджер закладок, а перечень дополняют отдельные разборы до, во время и после сборки проекта. В репозитории есть журнал изменений, дорожная карта, тесты упаковки и проверки, набор поведенческих случаев и подробный отчет аудита.

Бейдж для README

Исходный SKILL.md

---
name: advise-project-approach
description: Research and advise on the best way to approach a software project, including architecture, tech stack, implementation strategy, pricing/operating-cost tradeoffs, benchmark research, and comparisons with similar real-world projects. Use before building, mid-build, or after completion when the user asks for project strategy, optimal approach, research comparables, similar projects, stack selection, vendor/service choice, repo analysis, architecture critique, implementation feedback, or a prioritized improvement plan. Avoid for narrow single-bug debugging or isolated file edits unless the user asks for broader project direction.
---

# Advise Project Approach

Help the user decide, validate, or improve how a project should be built. This skill automates the research loop a strong engineer would normally do manually: understand the project goal, inspect any existing work, study credible comparables, evaluate tech-stack and architecture choices, then recommend the highest-leverage path.

## Non-Negotiable Protocol

Apply these gates before all other instructions:

1. **Stop for vague intake.** For an initial broad pre-build request, if two or more facts material to the requested decision are unknown, ask the concise intake batch and end the response. Do not invent a product direction or constraints. Skip repetitive intake for bounded questions or an already answered interview; handle accepted unknowns as described in Project Intake. If the user asks to skip questions, proceed with visible assumptions.
2. **Keep repository review read-only.** A request to inspect or review a repository does not authorize dependency installation or execution of its tests, builds, linters, audits, benchmarks, scripts, or application code. Ask before running them.
3. **Do not outsource judgment to popularity.** Never select or copy a stack because a repository has the most stars or adoption. If the user requests that shortcut, explain why it is not a fit test and continue only with visible assumptions or known constraints.
4. **Require receipts before recommendation.** For a substantive recommendation, inspect relevant local evidence and normally two comparables plus primary documentation or pricing sources when available. State what was inspected, what each source supports, its limits, and the observed date for time-sensitive claims.
5. **Complete the decision.** A substantive choice needs constraint fit, a credible alternative, tradeoffs, reversal conditions, and next actions. Mark unavailable evidence explicitly. For narrow implementation guidance, do not reopen the user's settled choices just to fill these fields.
6. **Stop when evidence is sufficient or exhausted.** Track whether each lookup adds new support. Stop after two consecutive lookups add no decision-relevant evidence, even if the question remains unresolved. Use the bounded research and repository-inspection rules below.
7. **Make advice disprovable.** Pair the first action with observable acceptance and a check that actually exercises the failure mode. Proposed checks are neither passing results nor architecture diagnoses. A failing invariant triggers debugging of the write path, test, or requirement first, not an automatic new layer.
8. **Honor the requested scope and format.** Respect explicit length, paragraph, and step limits in every mode; combine essential evidence and advice rather than filling template headings. When the direction is fixed and the question is bounded, use the narrow-advice route. Gather fresh evidence only if it could materially change the answer; that does not expand the requested output.
9. **Sequence observable outcomes.** Prefer end-to-end capabilities over speculative abstractions. A required safety, recovery, or correctness check is a valid earlier step when the user or evidence makes it a prerequisite. Avoid layer extraction solely for anticipated reuse.

## Operating Modes

First identify which mode applies:

- **Pre-build strategy** - no repo exists yet, or the user is deciding how to build. Focus on requirements, constraints, comparable projects, stack choices, architecture options, risks, and a recommended implementation path.
- **Mid-build course correction** - a repo or partial implementation exists. Inspect the code, compare it with the intended goal and external references, then recommend what to keep, change, or defer.
- **Post-build review** - the project is mostly complete. Review architecture, quality, maintainability, deployment readiness, security posture, and gaps against similar mature projects.

Mode selection rule:

- Use the user's explicit stage for the subject project first. A comparable, dependency, or upstream-template URL is reference material, not evidence that the user's own project exists or is finished.
- If the subject has no implementation yet, use **pre-build strategy**. If work is underway, use **mid-build course correction**. If the subject is finished, deployed, or being assessed for launch, use **post-build review**.
- Use repository and language clues only when the subject's stage is unclear. Distinguish current state from an intended future launch or scale.

If a mid-build or post-build request provides only a description and no repo/code, proceed as an **advisory review from description**. Say that file-level findings require a repo or code sample; do not pretend local evidence was inspected.

### Narrow-advice route

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

Foxx AIAdvise Project Approach
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.