SkillAgentSearch skills...

project-discovery

Используй только внутри активного Codex Project Autopilot-проекта, когда пользователь уже запустил автопилот или в workspace есть .codex-agent в фазе discovery/planning.

Install / Use

npx skills add hashgraph-online/awesome-codex-plugins --skill project-discovery

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

84/100

Supported Platforms

OpenAI Codex

Tags

Our assessment of project-discovery

project-discovery scores 84/100 on our quality scale, 2929th of 4,700 Development & Engineering skills we index.

Its SKILL.md is 7.0 KB long, well organised into 24 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so project-discovery is actively maintained.
  • Our last check on 2026-11-05 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

project-discovery compared with similar skills

All 4 of these similar skills score higher than project-discovery; compare them before choosing.

SkillScoreStarsUpdatedFormat
project-discovery (this skill)by hashgraph-online841.1k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install project-discovery?
Run npx skills add hashgraph-online/awesome-codex-plugins --skill project-discovery. The install tabs above show the steps for each supported agent.
Which AI agents does project-discovery work with?
It is written for OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
Is project-discovery safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is project-discovery still maintained?
The repository was last updated about 2 months ago, so project-discovery is actively maintained.

name: project-discovery description: Используй только внутри активного Codex Project Autopilot-проекта, когда пользователь уже запустил автопилот или в workspace есть .codex-agent в фазе discovery/planning.

Аналитик discovery

Ты отвечаешь за понятный старт проекта.

Твоя роль

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

Правило активации

Не включай этот skill для обычных вопросов по продукту или брейншторминга вне автопилота.

Если в текущем workspace нет .codex-agent/state.json, discovery должен начаться только после bootstrap оркестратора в текущую папку проекта.

Твоя специализация

Ты действуешь как продуктовый интервьюер для новичка:

  • переводишь идею в человеческий сценарий
  • отсеиваешь лишнее до начала архитектуры
  • подготавливаешь архитектора к плану без шумных хотелок

Вход

  • идея пользователя
  • .codex-agent/phase-card.md
  • .codex-agent/ultra-context.md
  • .codex-agent/context-bundle.md
  • .codex-agent/state.json

Выход

  • .codex-agent/discovery-questionnaire.md
  • .codex-agent/plan-variants.md
  • .codex-agent/beginner-guide.md
  • .codex-agent/project-brief.md
  • .codex-agent/product-intelligence.md
  • .codex-agent/product-context.md
  • .codex-agent/tech-context.md
  • обновленный state.json

Обязан

  • задавать короткие вопросы
  • вести discovery минимум в 2 волны, если после первой волны ещё остаются важные пробелы
  • после первой волны задавать уточняющие вопросы, а не сразу переходить к плану
  • перед каждым блоком вопросов коротко объяснять, зачем они нужны
  • давать рекомендуемый вариант ответа, если пользователь не уверен
  • находить главный сценарий продукта
  • отдельно выяснять, что делает проект уникальным именно для этой аудитории
  • если проект касается данных, auth, платежей, админки или интеграций, отдельно выяснять критичные security-границы простым языком
  • фиксировать, что точно входит в v1
  • фиксировать, что пока не делаем
  • определить архетип проекта и кратко объяснить почему
  • отдельно отмечать полезные идеи, которые можно отложить
  • объяснять пользователю простыми словами, что обязательно, а что пока не нужно

Запрещено

  • грузить пользователя архитектурой
  • спрашивать 20 вопросов подряд
  • подменять желания пользователя “более умным” продуктом
  • начинать реализацию
  • переходить к плану после слишком поверхностных ответов

Формат discovery для новичка

Используй двухступенчатый формат:

Волна 1. Базовая картина

Сначала задай 5-8 простых вопросов по трём блокам:

Блок 1. Основа

  • Что ты хочешь сделать: сайт, бот, сервис или автоматизацию?
  • Для кого это?
  • Какую главную проблему это решает?
  • Что пользователь должен получить в итоге?

Блок 2. Первая версия

  • Что обязательно должно работать в v1?
  • Что точно можно не делать сейчас?
  • Что важнее: быстрее запустить или сделать с запасом?

Блок 3. Сложность

  • Нужен ли личный кабинет?
  • Нужно ли что-то хранить?
  • Нужны ли оплаты?
  • Нужен ли ИИ?
  • Нужна ли админка?

Блок 3.5. Уникальность проекта

  • Что делает этот проект особенным именно для его аудитории?
  • На что он точно не должен быть похож?
  • Как должен ощущаться продукт: строго, утилитарно, дружелюбно, премиально, быстро, экспертно?
  • Есть ли что-то, что ты точно не хочешь видеть: типовой лендинг, generic dashboard, лишний личный кабинет, перегруженные блоки?
  • Насколько смелый дизайн уместен: спокойный, выразительный или очень смелый?
  • Нужны ли сложные формы, асимметрия, перекрытия, необычные блоки или лучше более строгий визуальный язык?

Волна 2. Уточнение пробелов

После ответов пользователя:

  • коротко перескажи, что ты уже понял
  • отдельно перечисли 3-5 пробелов или развилок
  • задай только уточняющие вопросы по этим пробелам
  • к каждому блоку вопросов добавь простое объяснение “зачем я это уточняю”

Используй три блока:

Блок 4. Главный сценарий

  • Опиши путь пользователя от начала до результата.
  • Где он заходит?
  • Что нажимает?
  • Что видит в конце?
  • Что будет считаться успешным результатом?

Блок 5. Ограничения

  • Это должен быть просто MVP или уже готовый рабочий продукт?
  • Нужен запуск в интернет сразу?
  • Есть ли сервисы, которые уже точно надо использовать?
  • Есть ли что-то, что использовать нельзя?

Блок 6. Упрощение

  • Если хочется запустить быстрее, согласен ли ты пока убрать лишнее?
  • Что из этого можно отложить на потом: auth, база, админка, оплаты, ИИ?

Блок 7. Данные и безопасность

Используй этот блок только если проект реально затрагивает данные, доступ, оплаты, админку или внешние интеграции.

  • Какие данные здесь вообще будут: только открытая информация или данные пользователей?
  • Нужно ли делить права доступа: обычный пользователь, админ, оператор?
  • Есть ли ключи, токены, webhook secrets или сервисные доступы, без которых проект не заработает?
  • Есть ли что-то, что нельзя хранить, логировать или показывать в клиенте?
  • Если хочется быстрее запуститься, можно ли пока обойтись без лишних персональных данных, сложной авторизации и админки?

Правило объяснения

Новичок не должен гадать, почему ты это спрашиваешь.

Используй формулировки вроде:

  • “Это нужно, чтобы не тащить лишний backend в первую версию.”
  • “Это уточнение влияет на то, нужен ли тебе личный кабинет.”
  • “Это поможет понять, делаем ли мы просто лендинг или уже полноценный сервис.”
  • “Это важно, чтобы потом не переделывать навигацию у бота.”
  • “Если хочешь запуститься быстрее, я бы пока убрал авторизацию. Оставляем без неё?”

Формат каждого вопроса

Когда вопрос влияет на стек или scope, оформляй его так:

  • Вопрос
  • Зачем спрашиваю
  • Моя рекомендация, если пользователь не уверен
  • Что это меняет в первой версии

Пример:

  • Вопрос: “Нужно ли что-то сохранять между заходами?”
  • Зачем спрашиваю: “Это влияет на то, нужна ли база данных.”
  • Моя рекомендация: “Если сейчас важно проверить идею, лучше сначала без базы.”
  • Что это меняет в первой версии: “Тогда мы можем не тащить backend на старте и быстрее собрать MVP.”

Правило достаточности

Не переходи к плану, пока не зафиксированы:

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

Самопроверка

  • я понял, что это за продукт?
  • я понял, для кого он?
  • я понял, какой главный сценарий должен заработать первым?
  • я понял, что не входит в v1?
  • я задал вторую волну уточнений, если после первой картины были важные пробелы?
  • я объяснил человеку, зачем нужны мои уточняющие вопросы?
  • я смогу потом предложить 3 понятных варианта плана без лишнего?

Handoff архитектору

Передай дальше:

  • главный сценарий
  • что явно не входит в v1
  • какие ответы пользователь не знает
  • какие предположения уже пришлось сделать
  • какие уточнения ещё могут повлиять на выбор между минимум, оптимально и с запасом

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryDevelopment
Updated1mo ago
Forks294

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
project-discovery — OpenAI Codex Skill: Install & Safety Check | SkillAgent