Imported from tiangong-ai/agent-skills (tiangong-kb-course-fulltext-fetch/SKILL.md). Install upstream with npx skills add tiangong-ai/agent-skills --skill tiangong-kb-course-fulltext-fetch. Copyright stays with the author.

Tiangong KB Course Fulltext Fetch

Use this skill when the task has a Tiangong KB course document_id and tags, and needs the full processed text for that document.

Boundary

Always call the Tiangong AI CLI:

npx @tiangong-ai/cli@0.0.19 kb course fulltext --document-id <document_id> --tags <tags>

Do not call S3, NAS, Supabase, Pinecone, or OpenSearch directly from the skill. The CLI owns the S3 path rule, list/get behavior, and AWS SDK credential handling.

Prerequisites

• The wrapper defaults to npx @tiangong-ai/cli@0.0.19; users do not need a preinstalled CLI. Set TIANGONG_AI_CLI or TIANGONG_AI_CLI_BIN only to override the CLI entrypoint.
• AWS credentials must already be available in the environment through the AWS SDK default chain, such as AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_PROFILE, AWS_REGION, or AWS_DEFAULT_REGION.
• If credentials live in a dotenv file, pass env_file. Loaded dotenv values only fill unset environment variables; explicit JSON fields such as bucket, prefix, and region are passed as CLI flags and take precedence. Never print secret values.

Fetch Full Text

Pass the course document_id and tags:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities"
}'

The wrapper calls:

npx @tiangong-ai/cli@0.0.19 kb course fulltext --document-id <document_id> --tags <tags>

To save the full text:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities"
}' ./fulltext.txt

To return CLI metadata and text as JSON:

./scripts/course_fulltext_fetch.sh '{
  "document_id": "000125ed-c4d9-4fe3-9383-281162406d66",
  "tags": "thu_humanities",
  "json": true
}'

Input Fields

• document_id or documentId: required course document id.
• tags or tag: required course tag, such as thu_humanities.
• output_file: optional output path. The second wrapper argument takes precedence when both are provided.
• env_file: optional dotenv file to load before calling the CLI.
• json: true to return the CLI JSON payload instead of plain text.
• bucket, prefix, region: optional overrides for the CLI command.

When using the returned text in reader-facing prose, cite source titles or paths when useful, but do not describe internal S3 paths, AWS credentials, or retrieval mechanics unless the user asks for implementation details.