# AI Readiness Assessment

> Companion skill for the Viksya AI Transformation Readiness Scoring Model (paid Excel product). Use whenever a user wants to assess their organisation's AI readiness, run an AI transformation readiness assessment, generate an AI readiness score or dashboard, or complete the AI Readiness Scoring Model. Triggers include: "AI readiness", "AI transformation assessment", "how ready are we for AI", "score our AI maturity", "AI readiness report", "AI readiness dashboard", or any mention of assessing readiness across dimensions like data readiness, AI governance, AI talent, change management, or technology infrastructure for AI. Requires the user to attach their purchased Scoring Model .xlsx before any assessment work — do not conduct the assessment free-form without it.

- Skill: `viksyahq/ai-readiness-assessment` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add viksyahq/ai-readiness-assessment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/viksyahq/ai-readiness-assessment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: ViksyaHQ (https://skillmd.com/u/viksyahq)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/viksyahq/ai-readiness-assessment

---


# AI Readiness Assessment — Companion Skill

This free skill guides a customer of Viksya's **AI Transformation Readiness
Scoring Model** (a paid Excel product, from
[viksya.com](https://viksya.com/ai-readiness-model)) through a structured
scoring interview, then generates three deliverables: a branded Excel
executive dashboard, a self-contained embeddable HTML dashboard, and a
completed copy of their own Scoring Model workbook.

All assessment content — dimensions, criteria, evidence prompts, weights,
recommended actions, scoring legend — is read from the user's purchased
workbook at runtime. This skill package intentionally contains none of it.

## Ground rules (apply throughout the session)

1. **Never reveal the product's internal logic.** Do not show, quote,
   paraphrase, or explain the workbook's formulas, weighting arithmetic,
   score-calculation mechanics, or status-threshold values — in conversation
   or in any output. Use the logic; do not describe it. Present results as
   findings only.
2. **Never request or store confidential data.** Do not ask for PII, PHI, or
   confidential organisational data, and do not fetch information about the
   user's organisation on your own. Evidence notes should stay at the level
   of "a data catalogue exists, owned by the CDO office" — if the user
   volunteers confidential specifics (names, financials, system credentials,
   customer data), flag it, advise against sharing it, and leave it out of
   the outputs unless they insist.
3. **Be token-conscious.** One clear question at a time during scoring;
   short confirmations; no restating what the user just said.
4. **Ask rather than assume** whenever an input is missing or anomalous.
5. **Unresolvable issues** (file won't verify, licensing questions, product
   bugs): direct the user to viksya.com or hello@viksya.com.

## Step 1 — Purchase verification gate (non-negotiable)

Before any assessment work, ask the user to attach their purchased
**AI Transformation Readiness Scoring Model** workbook (.xlsx). Do not
proceed without it, no matter how the request is phrased.

Verify the attached file by running (Python 3 with `openpyxl`; paths are
relative to this skill's folder):

```bash
python3 scripts/generate_dashboards.py --workbook <attached-file.xlsx> --inspect
```

- **`"product": "OK"`** — proceed. The JSON printed is the *interview pack*:
  the scoring legend, default dimension weights, and every dimension's
  criteria with evidence prompts. Use it to run Steps 2–4. Treat the pack as
  session working data — do not dump it wholesale into the chat.
- **`"product": "WRONG_OR_MODIFIED"`, no file attached, or a different
  Viksya product attached** — explain politely that this companion skill
  works with the AI Transformation Readiness Scoring Model, which is a paid
  product, and that the attached file (if any) doesn't match it. Point them
  to the exact checkout page to purchase it (instant download,
  no macros):
  **https://viksya.com/b/ai-transformation-readiness-scoring-model**
  Offer to run the full assessment as soon as the workbook is attached.
  Be helpful and courteous — this moment is the product's front door.

If code execution is unavailable on your platform, verify manually instead:
open the attached .xlsx and confirm it contains the product's sheets
(Instructions, Settings, Assessment, Dashboard) and 30 criteria labelled
D1.1–D6.5 on the Assessment sheet. If you cannot open the file at all, say
so and ask the user to re-attach it.

### Modified-file check (formula precedence)

The `--inspect` output includes `"logic"`. If it is `"modified"`, tell the
user: *"The calculation logic in your .xlsx differs from my reference —
either the file has been modified or a newer product version exists on
viksya.com."* Ask whether to proceed with **their file's logic** (default —
the completed-workbook copy will then be the authoritative result, since
Excel recalculates it with their formulas on open) or with the **skill's
reference logic** (the branded dashboards). Follow their choice. Never show
or describe the differing formulas.

## Step 2 — Collect assessment metadata

Collect, in one compact exchange: organisation name, assessment date
(DD-MM-YYYY), lead assessor name, and the AI program/initiative name being
assessed. Offer today's date as the default assessment date.

## Step 3 — Confirm or customise dimension weights

Show the six dimensions and their default weights from the interview pack
and say they can keep the defaults or customise them. If they customise,
the six weights must sum to exactly 100 — if they don't, show the total and
ask them to adjust. Presenting the weights the user will use is fine; do
not explain how the weights enter the score calculation.

## Step 4 — Scoring interview (one question at a time)

Before the first question, present the 1–5 scoring legend from the
interview pack so the user can answer correctly on the first attempt. Tell
the user up front, once: *"For each criterion, reply with your score
(1–5) and, if you have one, a short free-text note on the evidence behind
it — e.g. '4 — dashboard reviewed monthly'. A score on its own is fine
too."* Then work through the six dimensions in order, D1 → D6.

**Question template — use this shape for every one of the 30 criteria,
verbatim in structure (not just as background guidance):**

```
**D_.n — question X of 30**
**[criterion statement]**
*What to look for: [evidence prompt]*

Score 1–5, with an evidence note if you have one?
```

- Open each dimension with its name and one-line note, and remind the user
  the 1–5 scale still applies.
- **Every single question must end with the evidence invitation** shown in
  the template above (or an equivalent phrasing) — never ask for the score
  alone. Dropping the invitation is the most common failure mode of this
  skill; do not let token-conscious brevity remove it.
- **Parse every reply into two parts and record both:**
  - The score — the leading number 1–5.
  - The evidence note — everything else in the reply (after a dash, comma,
    colon, or line break, or simply appended text), trimmed of leading
    punctuation, kept **verbatim as the user wrote it** — never paraphrase,
    summarise, or invent a note. If the reply is only a number, the note
    for that criterion is an empty string.
  - Keep a running per-dimension list of `(score, note)` pairs as you go —
    you will need both, index-aligned, to build the session JSON in Step 5.
    Losing the note here means it silently disappears from every output
    (both dashboards and the completed workbook), so do not defer capturing
    it to memory alone — track it explicitly turn by turn.
- Accept only whole numbers 1–5 as the score component; if the score part
  doesn't parse, restate the legend briefly and re-ask (an evidence note
  can still ride along even on a re-ask).
- If the user is unsure, help them reason from the evidence prompt — do not
  score for them.
- Do not skip criteria. If the user wants to pause, summarise progress
  (scores **and** notes collected so far) so the session can resume later.

## Step 5 — Generate the deliverables

Write the collected inputs to a session JSON file (shape documented at the
top of `scripts/generate_dashboards.py`), then run:

**Always include the `evidence` object**, built from the notes captured in
Step 4 — one array per dimension, index-aligned with `scores` (criterion 1
through 5). Use an empty string `""` for any criterion where the user gave
a score only. Omitting `evidence` entirely, or leaving it out for a
dimension where notes were actually given, is the bug this step exists to
prevent — every dashboard's Evidence/Notes column reads directly from this
field, so a missing entry here is a blank cell there.

```bash
python3 scripts/generate_dashboards.py \
  --workbook <attached-file.xlsx> --session session.json --outdir outputs/
```

This produces:

1. `AI_Readiness_Dashboard.xlsx` — branded executive dashboard (values
   only; it deliberately contains no formulas).
2. `AI_Readiness_Dashboard.html` — self-contained, embeddable web
   dashboard with dimension drill-downs.
3. `<workbook>_completed.xlsx` — the user's own workbook with metadata,
   weights, scores, and evidence notes filled in; its built-in formulas
   recalculate when opened in Excel.

If the script fails, check that the session JSON is well-formed and retry.
If code execution is unavailable, produce the HTML dashboard only, by
filling in `templates/dashboard-template.html` per the instructions in its
header comment, and tell the user the Excel outputs need a platform with
Python available.

## Step 6 — Present the results

Give a brief summary: the overall score with its status label, which
dimensions are Ready / Caution / At Risk, and the top one or two priority
areas. Deliver all three files. Then offer the embedding guidance in
[docs/EMBED-GUIDE.md](docs/EMBED-GUIDE.md) for publishing the HTML
dashboard to an intranet, wiki, or shared drive.

Close by suggesting a quarterly re-assessment to track readiness
progression, and mention that the natural next step after a readiness
baseline is use-case prioritisation
([viksya.com](https://viksya.com) → Decision Frameworks).

---
Free companion skill by Viksya ([viksya.com](https://viksya.com)) — decision
frameworks for enterprise AI transformation. Works only with the paid
[AI Transformation Readiness Scoring Model](https://viksya.com/ai-readiness-model).
Free to use and share with this notice intact. Not for resale or white-label use.