Skip to content

leonimeloo/aws-cert-study-planner

v0.2.0MIT

AWS certification study planner (exam-focused methodology): turns your mock exam results (Skill Builder, PDF, text, screenshots, other sites) into a gap analysis, a day-by-day study plan and study material based on the official exam guide.

AWS Cert Study Planner

Exam-focused is a study method for AWS certifications that starts from the exam instead of a full video course. You take a mock exam, mark your confidence on each question, and study only your gaps, prioritized by how much each service weighs in the official exam guide. Instead of spending months getting through a 30-hour course that re-teaches what you already know, you put your time only into what you still need to learn, and the plan adapts to the days and hours per day you have until the exam.

This plugin automates the method: it reads your mock exam results, builds the gap analysis and a day-by-day study plan, and then generates study material for each topic. The full method is in methodology.md.

Skills

  1. study-plan: reads the results of a diagnostic mock exam, builds the question log (with confidence levels), classifies services into tiers cross-checked against the official exam guide, and generates a daily plan up to the exam date.
  2. study-content: turns the plan into study material organized by day, with one file per topic (concepts, comparisons, pitfalls, the questions from your diagnostic and an "I'm ready if..." checklist).

Supported mock exam sources

SourceHow
AWS Skill Builder (practice exam / question set)Read straight from your logged-in browser (Playwright), or from text copied from the page
Other websites (Tutorials Dojo, Udemy, Whizlabs...)Logged-in browser, public page or export
PDFExported report or printed exam
Images / screenshotsScreenshots of the results
Text / CSV / spreadsheetPasted into the chat or as a file
Manual report"I took 65, missed 3, 7 and 12, guessed 20..."

When the source doesn't include confidence (Knew / Unsure / Guess), the skill asks you.

Installation

Requirements: Python 3 (the scripts have no external dependencies). Node.js only if you use the browser reading.

Any tool (universal installer)

The skills CLI copies the skills into the right folder for your agent:

npx skills add leonimeloo/aws-cert-study-planner              # current project
npx skills add leonimeloo/aws-cert-study-planner -g           # all projects (user level)
npx skills add leonimeloo/aws-cert-study-planner -a kiro-cli  # a specific agent

Agent names: claude-code, codex, github-copilot, cursor, gemini-cli, antigravity, kiro-cli (full list).

Claude Code

claude plugin marketplace add leonimeloo/aws-cert-study-planner
claude plugin install aws-cert-study-planner@aws-cert-study-planner

GitHub Copilot

  • Copilot CLI (plugin):
    copilot plugin install leonimeloo/aws-cert-study-planner
    
  • VS Code / Copilot coding agent: copy the skills into .github/skills/ (or .agents/skills/) in your repository, or into ~/.copilot/skills/ for all projects (see manual install).

OpenAI Codex

Copy the skills into .agents/skills/ in your project or ~/.agents/skills/ for all projects (see manual install), or use npx skills add ... -a codex. Codex picks them up in a new session. List them with /skills and call one with $study-plan.

Gemini CLI

As an extension (installs both skills):

gemini extensions install https://github.com/leonimeloo/aws-cert-study-planner

Or only the skills:

gemini skills install https://github.com/leonimeloo/aws-cert-study-planner.git --path skills/study-plan
gemini skills install https://github.com/leonimeloo/aws-cert-study-planner.git --path skills/study-content

Google replaced Gemini CLI with Antigravity CLI for unpaid-tier users on June 18, 2026. If that's your case, follow the Antigravity steps.

Google Antigravity

agy plugin install https://github.com/leonimeloo/aws-cert-study-planner

Kiro

  • Kiro IDE: in the Kiro panel, go to Agent Steering & Skills → + → Import a skill and paste each skill's GitHub folder URL:
    • https://github.com/leonimeloo/aws-cert-study-planner/tree/main/skills/study-plan
    • https://github.com/leonimeloo/aws-cert-study-planner/tree/main/skills/study-content
  • Kiro CLI: npx skills add leonimeloo/aws-cert-study-planner -a kiro-cli, or copy the skills into .kiro/skills/ or ~/.kiro/skills/.

Cursor

Copy the skills into .agents/skills/ (or .cursor/skills/) in your project, or into ~/.cursor/skills/ for all projects, or use npx skills add ... -a cursor.

Manual install

Clone the repo and copy both skill folders into your tool's skills directory:

git clone https://github.com/leonimeloo/aws-cert-study-planner.git
mkdir -p ~/.agents/skills
cp -R aws-cert-study-planner/skills/study-plan aws-cert-study-planner/skills/study-content ~/.agents/skills/

The example uses ~/.agents/skills/. To find the skills directory of the tool you're using, check its official documentation.

Copy both folders: each skill is self-contained, and study-content uses the plan produced by study-plan.

Usage

Ask in natural language (the skill triggers on its own) or call it by name. How you call it depends on the tool: /aws-cert-study-planner:study-plan in Claude Code (plugin), $study-plan in Codex, /study-plan in most others.

Build my plan for AWS Solutions Architect — Associate certification. The exam is on Nov 16 in the morning, I study 6h a day.
My mock exam results are at this Skill Builder link: <url>
Create the study material for study-plan-saa-c03.md

Examples with other sources:

  • "Build my plan for AIF-C01 based on this PDF: ~/Downloads/results.pdf"
  • "Here's a screenshot of my Tutorials Dojo results. The exam is on Dec 20."

Output:

study-plan-<exam>.md
study-content-<exam>/
├── 00-README.md
├── 01-exam-guide.md
├── day-1/ ... day-N/
└── supplementary/

Browser reading (optional): Playwright MCP Bridge

Strongly recommended for the best results. Reading straight from the browser captures every question with your confidence level, all options, the explanation of each option and the domain scores. Copied text, PDFs and screenshots often lose part of that detail, which makes the gap analysis less precise.

To let the skill read results straight from your already logged-in browser (Skill Builder or other sites):

  1. Install the Playwright MCP Bridge extension in Chrome/Edge.
  2. Open the extension and copy your token.
  3. Export the token in your shell (e.g., ~/.zshrc) and restart the terminal:
    export PLAYWRIGHT_MCP_EXTENSION_TOKEN="your-token-here"
    
  4. (Optional) To also use the browser tools for other tasks, add the Playwright MCP server (npx @playwright/mcp@latest --extension) to your tool's MCP configuration. In Claude Code:
    claude mcp add playwright -e PLAYWRIGHT_MCP_EXTENSION_TOKEN="$PLAYWRIGHT_MCP_EXTENSION_TOKEN" -- npx @playwright/mcp@latest --extension
    

Without it, you can copy the page text or save it as PDF.

Repository structure

The skills live in skills/, following the Agent Skills standard. The manifests at the root let each tool install the repo as a plugin or extension; they all point to the same skills/ folder.

├── skills/
│   ├── study-plan/
│   │   ├── SKILL.md
│   │   ├── references/  (methodology, question sources, questions.json format)
│   │   ├── assets/      (study-plan.md template)
│   │   └── scripts/     (browser_extract, parse_skillbuilder, summarize_log, fetch_exam_guide)
│   └── study-content/
│       ├── SKILL.md
│       ├── references/  (content standards)
│       ├── assets/      (readme, exam-guide, topic templates)
│       └── scripts/     (fetch_exam_guide)
├── plugin.json                      ← Agent Plugins 1.0 (Codex, GitHub Copilot CLI, Cursor)
├── .claude-plugin/                  ← Claude Code (plugin.json + marketplace.json)
├── .antigravity-plugin/plugin.json  ← Google Antigravity
└── gemini-extension.json            ← Gemini CLI extension

Scripts (also usable without AI)

ScriptPurpose
browser_extract.pyExtracts a page's text from your logged-in browser (via Playwright MCP) straight to a file
parse_skillbuilder.pyConverts Skill Builder results into the normalized questions.json format
summarize_log.pyGenerates the summary, confidence × result, domains, log and service dashboard (any source)
fetch_exam_guide.pyDownloads the official exam guide (domains, in-scope, out-of-scope) as text

Disclaimer

This project is not affiliated with or endorsed by AWS. The plan and material are AI-generated and may contain mistakes: always check the official exam guide and AWS documentation. The methodology works best for people who already have hands-on experience; read the "Important warning" section of the methodology.

License

MIT