Skip to content

feat(skill): make it clear that labs bill the learner's account - #23

Merged
jhermesn merged 1 commit into
mainfrom
docs/emphasize-lab-costs
Nov 17, 2026
Merged

jhermesn merged 1 commit into
mainfrom
docs/emphasize-lab-costs

Conversation

@jhermesn

Copy link
Copy Markdown
Owner

What and why

A reader pointed out that the infrastructure cost of the labs needs to be stated much more strongly. The README mentioned cost only in "Cost and safety", near the end, and each lab showed an estimate table with a single warning line, so it was easy to read the estimate as the whole story.

Now the cost is stated where people act:

  • README
    • A warning callout right after the introduction: labs deploy real resources in the reader's own account, AWS bills that account, the estimate holds only if cleanup.sh runs, and resources created by hand in the Console bill too.
    • A new "Set a budget" step in Get started, before the first lab, with a link to AWS Budgets.
    • The cleanup step now says to run it every time, even when stopping halfway.
  • Lab template (assets/lab/README.md), and the two example labs to match:
    • "Before you start" opens with a bold line saying the lab creates billable resources until Cleanup runs, and asks for a study account with a budget alert.
    • The cost note says the figures are on-demand estimates and that resources keep billing until Cleanup, including what the learner creates during the challenges.
    • Cleanup says to run it even if the learner did not finish.
  • SKILL.md: after the report, the agent tells the user plainly that deploying a lab bills their account until cleanup.sh runs, and that a budget alert is the safety net.

bash tests/run.sh passes locally, including the validator on both example labs.

Readers took the estimated cost table as the whole story. Labs now say up front that they create billable resources until cleanup runs, and ask for a budget alert before the first one.
@jhermesn
jhermesn merged commit b0cbf5b into main Nov 17, 2026
1 check passed
@jhermesn
jhermesn deleted the docs/emphasize-lab-costs branch November 17, 2026 12:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant