maiconfz--ai-first-project-readiness--ai-first-chat

Analyze AI-first project readiness from public URLs, uploads, or pasted sources.

3|1|Updated May 2, 2026
One-click install
npx skills add https://github.com/agents-repo/registry --skill maiconfz-ai-first-project-readiness-ai-first-chat-agents-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maiconfz--ai-first-project-readiness--ai-first-chat
Source: https://github.com/agents-repo/registry/tree/main/.cursor/skills/maiconfz/ai-first-project-readiness/maiconfz--ai-first-project-readiness--ai-first-chat
Command: npx skills add https://github.com/agents-repo/registry --skill maiconfz-ai-first-project-readiness-ai-first-chat-agents-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Evaluating whether a project is ready for AI-first development normally requires local repository access, which chat-web sessions do not have. This Skill assesses AI-first readiness directly from public project URLs, uploaded files, or pasted content, producing a structured readiness report without cloning or inspecting a host working tree. ## Core Features & Use Cases - Remote Evidence Analysis: Fetches up to 15 public files (README, specs, CI configs, agent instructions) from GitHub or other git-forge URLs to ground the assessment. - Structured Readiness Report: Emits a markdown report covering dimensions like documentation, agent/skill inventory, tooling, eval harnesses, and CI, with per-finding severity, evidence, and suggestions. - Interview Fallback: When no usable evidence exists, it interviews the user with targeted questions instead of inventing repository facts. - Use Case: Paste a GitHub repository URL into a chat session and receive a gap analysis of its AI-first readiness, plus a handoff pointing you to run planning in an IDE. ## Quick Start Ask the agent to analyze the AI-first readiness of a public GitHub repository by pasting its URL into the chat.

Frequently Asked Questions about maiconfz--ai-first-project-readiness--ai-first-chat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a GitHub repository's AI-first readiness without cloning it?▼

Paste the public repository URL into the chat. The agent fetches up to 15 key public files such as README, specs, CI configs, and agent instructions, then emits a structured readiness report with severity-graded findings.

What evidence sources can I use for a readiness assessment in chat?▼

Three sources are supported in priority order: a usable public project URL, consumer-provided attachments or uploads, and pasted file contents or tree listings. Marketing or landing pages alone are not usable evidence.

Can this agent analyze private repositories or local files?▼

No. It only fetches public HTTPS URLs and never clones repositories, calls gh, or inspects a host working tree. For private repos, upload files or paste key contents, or install the package in an IDE for local analysis.

What does the readiness report contain?▼

The markdown report includes a summary, what is already working, and gaps grouped by dimensions like documentation, agent inventory, tooling, and CI. Each finding has a severity level, evidence citation, suggestion, and impact estimate.

Why did the agent ask questions instead of producing a report?▼

A report is only emitted when usable URL, upload, or paste evidence exists. If evidence is missing, unreadable, or only a marketing page, the agent interviews you rather than inventing repository facts.

Can this chat agent create an improvement plan for my project?▼

No. Planning is explicitly out of scope for this chat agent. After a report, it directs you to install the package in an IDE and run the ai-first-project-planning flow there.