deploy

skills/activities/SKILL.md

@@ -13,9 +13,13 @@ For write, update, or delete operations, state the intended action before callin
 
 For visible lesson content, prefer `POST /api/v1/activities/` with
 `activity_type=TYPE_DYNAMIC`, `activity_sub_type=SUBTYPE_DYNAMIC_MARKDOWN`,
-markdown stored in `content`/`details`, `lock_type=public`, and `published=true`
-unless the user asks for drafts. Always use the target chapter's own
-`chapter_id`; do not attach every activity to the first chapter. On
+`content.markdown_url`, `lock_type=public`, and `published=true` unless the user
+asks for drafts. The LearnHouse markdown renderer reads `activity.content.markdown_url`;
+it does not render inline `content.body` or `content.markdown` by itself. If no
+external markdown URL is available, provide inline markdown in `content.markdown`
+or `content.body`; the agent runtime converts it to a `data:text/markdown` URL
+before calling LearnHouse. Always use the target chapter's own `chapter_id`; do
+not attach every activity to the first chapter. On
 `PUT /api/v1/activities/{activity_uuid}`, do not send `published_version`;
 this LearnHouse backend rejects that field.
 

skills/courses/SKILL.md

@@ -22,6 +22,7 @@ Deployment context for this LearnHouse instance:
 - Course creation must send multipart form fields `name`, `description`, `public`, and `about`. If the user only gives a title, use it as `name`, provide short `description` and `about` values, and set `public=false` unless the user asks for a public course.
 - When the user asks for a course with lessons, modules, or activities, do not stop after creating the course and chapters. Create at least one activity per chapter, using each chapter's own returned `chapter_id`.
 - Do not attach all generated activities to the first chapter. Verify the resulting course metadata shows activities distributed under the intended chapters.
+- Markdown lesson activities must have `content.markdown_url`. Inline markdown is converted to a `data:text/markdown` URL by the runtime when no external URL is available.
 - For smoke/status checks, use course count or course list with default `org_slug=default`; do not call `GET /api/v1/health` as a preflight.
 - Course creation and course management require `LEARNHOUSE_AUTH` consumer setup.