ai-readiness-assessment — Claude Code skill: install and overview
ai-readiness-assessment evaluates business readiness for AI adoption across six dimensions and generates an ai-readiness-report.md document with gap analysis.
MIT 260 installs ★ 440 updated 2026-10-20
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a claude-codeWhat ai-readiness-assessment does
The skill audits an organization across six operational dimensions: data maturity, tech stack, team skills, process documentation, budget, and culture. Each area is rated on a 1 to 5 scale using the detailed rubric in references/dimensions.md. The agent collects evidence through dialogue, codebase inspection, and document review, then calculates a weighted total score.
Methodology from references/methodology.md governs the workflow. Any dimension scoring below 4.0 triggers a gap analysis that maps current state, target state, business impact, and required effort. A score of 1.0 serves as a hard blocker: the rules explicitly mandate halting AI initiatives until the underlying issue is resolved. Final recommendations are structured across five priority tiers tailored to company size.
Output is formatted as ai-readiness-report.md. The guidelines prohibit score inflation, unsubstantiated claims, and unexplained technical jargon, ensuring the assessment remains useful for business executives.
What it helps with
- audit company infrastructure and data maturity for AI initiatives
- identify critical organizational gaps before funding AI projects
- calculate an evidence-based AI readiness score across core business areas
- generate a structured ai-readiness-report.md report with prioritized recommendations
Example prompts for the agent
- Run an AI readiness evaluation for our organization following the OneWave AI methodology.
- Assess our codebase and documentation to produce an ai-readiness-report.md report.
- Review our team skills and technical stack, then highlight gaps scoring below 4.0.
How to install ai-readiness-assessment
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a claude-code2Manually: put the files in place
~/.claude/skills/ai-readiness-assessment/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-readiness-assessment/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a codex2Manually: put the files in place
.agents/skills/ai-readiness-assessment/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a cursor2Manually: put the files in place
.cursor/skills/ai-readiness-assessment/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills ai-readiness-assessment2Manually: put the files in place
.github/skills/ai-readiness-assessment/SKILL.md1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a gemini-cli2Platform CLI
gemini skills install https://github.com/OneWave-AI/claude-skills --path ai-readiness-assessmentManually: put the files in place
.devin/skills/ai-readiness-assessment/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-readiness-assessment
How to install ai-readiness-assessment in Claude Code?
Run the installation command npx skills add OneWave-AI/claude-skills --skill ai-readiness-assessment -a claude-code. The skill file is placed in ~/.claude/skills/ai-readiness-assessment/SKILL.md.
What does ai-readiness-assessment do?
It evaluates an organization across six dimensions, scores each area from 1 to 5, and creates an audit report with gap analysis and recommended next steps.
What happens when an area receives a 1.0 score?
The assessment marks that area as a deal-breaker, explicitly advising against launching AI projects until the baseline deficiency is resolved.
Source text
SKILL.md · MIT
--- name: ai-readiness-assessment description: Assesses how ready a business is for AI adoption across six dimensions. Evaluates data maturity, tech stack, team skills, process documentation, budget, and culture. Generates a comprehensive ai-readiness-report.md with scores, gap analysis, and recommended starting points. Aligned with OneWave AI's audit methodology. tools: Read, Write, Glob, Grep, Bash, WebSearch, WebFetch model: inherit --- # AI Readiness Assessment Skill Conduct a structured, evidence-based evaluation of a business's readiness for AI adoption across six dimensions, then produce a detailed `ai-readiness-report.md` covering scores, gap analysis, and prioritized next steps. Aligned with OneWave AI's pragmatic, ROI-driven audit methodology. ## Contents - `references/dimensions.md` — The six dimensions, full 1-5 scoring rubric, and key questions per dimension. - `references/methodology.md` — Information-gathering, scoring math and interpretation table, gap analysis, recommendation priorities, company-size and industry tailoring, and conversation flow. - `references/output-template.md` — The complete `ai-readiness-report.md` structure to fill in. ## Workflow 1. Gather context. Collect information through conversation, document review, and codebase analysis. See `references/methodology.md` (Phase 1) for channels and the question set in `references/dimensions.md`. 2. Score the six dimensions. Rate each from 1 to 5 against the rubric in `references/dimensions.md`. Be honest and conservative, use half-points for nuance, and record the evidence behind every score. 3. Calculate the overall score. Apply the weighted formula and map it to a readiness level using the table in `references/methodology.md` (Phase 2). 4. Run the gap analysis. For each dimension below 4.0, document current state, target state, the gap, its impact, and the effort to close it (Phase 3). 5. Build recommendations. Produce prioritized actions across the five OneWave priority tiers, tailoring for company size and industry (Phase 4 and tailoring section). 6. Generate the report. Write `ai-readiness-report.md` following `references/output-template.md`, then highlight the top 3 immediate actions. ## The Six Dimensions | Dimension | Weight | |-----------|--------| | Data Maturity | 25% | | Technology Stack | 20% | | Team Skills and Capacity | 20% | | Process Documentation | 15% | | Budget and Resources | 10% | | Organizational Culture | 10% | See `references/dimensions.md` for the full rubric and questions. ## Core Rules 1. Never inflate scores. A business that scores 2.0 needs to hear that honestly; false optimism wastes money and time. 2. Always provide evidence. Back every score with specific observations, not assumptions. 3. Be actionable. Pair every identified gap with a concrete recommendation. 4. Respect budget realities. Include cost-appropriate options; not every organization needs enterprise-grade solutions. 5. Use no jargon without explanation. The report is read by business leaders, not only technologists. 6. Flag deal-breakers. When a dimension scores 1.0, state explicitly that AI initiatives should not begin until it is addressed. 7. Consider the full cost. Include ongoing costs (maintenance, retraining, monitoring), not just implementation. 8. Recommend the right AI. Match recommendations to actual readiness; do not recommend deep learning to a company that has not consolidated its data. 9. Maintain OneWave AI alignment. Frame all recommendations within pragmatic, ROI-driven AI adoption. Avoid hype; focus on business value. 10. Use no emojis. Keep all output professional and text-based.
© OneWave-AI · MIT · OneWave-AI/claude-skills