knowfun

# Knowfun.io API Skill

This skill helps you interact with the Knowfun.io OpenAPI to generate educational content, posters, games, and films.

## Prerequisites

Before using this skill, you need:
1. A Knowfun.io API Key (get it from https://www.knowfun.io/api-platform)
2. Sufficient credits in your account

## Configuration

Set your API key as an environment variable:
```bash
export KNOWFUN_API_KEY="kf_your_api_key_here"
```

Or the skill will prompt you for it when needed.

## Available Commands

When invoked, this skill supports the following operations:

### 1. Create a Task

Generate content by creating a task. Supports four types: `course`, `poster`, `game`, `film`.

**Basic Example:**
```bash
/knowfun create course "Introduction to Machine Learning"
/knowfun create poster "Climate Change Facts"
/knowfun create game "Learn Python Basics"
/knowfun create film "History of the Internet"
```

**With URL:**
```bash
/knowfun create course https://example.com/document.pdf
```

### 2. Check Task Status

Check the status of a task by its ID:
```bash
/knowfun status <taskId>
```

### 3. Get Task Details

Get detailed information about a completed task:
```bash
/knowfun detail <taskId>
```

### 4. List Tasks

List recent tasks:
```bash
/knowfun list
```

### 5. Check Credits

Check your credit balance:
```bash
/knowfun credits
```

### 6. Get Schema

Get available configuration options for each task type:
```bash
/knowfun schema
```

## Task Configuration

Each task type has specific configuration options. See [api-reference.md](api-reference.md) for complete details.

### Course Configuration
- **contentStyle**: detailed, concise, conversational
- **contentLanguage**: zh, en, etc.
- **explainLanguage**: zh, en, etc.
- **voiceType**: standard voice options
- **ttsStyle**: classroom, professional, etc.

### Poster Configuration
- **usage**: infographic (default), businessReports, marketing, illustration
- **style**: handDrawn (default), photorealistic, anime, sciFi, custo...

# Knowfun Skills - Multi-Platform AI Integration

English | [简体中文](README_CN.md)

Multi-platform AI coding assistant integration for Knowfun.io API. Generate educational content, posters, games, and films using Claude Code, Cursor, Cline, or OpenClaw.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Claude%20Code%20%7C%20Cursor%20%7C%20Cline%20%7C%20OpenClaw-orange.svg)](PLATFORM_COMPARISON.md)
[![npm](https://img.shields.io/badge/npm-knowfun--skills-red.svg)](https://www.npmjs.com/package/knowfun-skills)
[![ClawHub](https://img.shields.io/badge/ClawHub-knowfun--skills-blue.svg)](https://clawhub.ai/duguyixiaono1/knowfun-skills)

## What is Knowfun.io?

Knowfun.io is an AI-powered platform that transforms text and documents into engaging educational content:
- 📚 **Courses**: Interactive presentations with narration
- 🎨 **Posters**: Visual infographics and marketing materials
- 🎮 **Games**: Interactive learning experiences
- 🎬 **Films**: Educational videos and documentaries

## Features

### Platform Support
- 🎯 **Claude Code** - Native `/knowfun` skill commands
- 🎯 **Cursor** - CLI tool + rules integration
- 🎯 **Cline** - CLI tool + JSON config
- 🎯 **OpenClaw** - CLI tool + skill definition

### Capabilities
- ✅ Create content generation tasks via natural language
- ✅ Monitor task status and progress
- ✅ Retrieve generated content
- ✅ Manage credits and API usage
- ✅ Get configuration options and schemas
- ✅ Multi-language support (English + 简体中文)

## Quick Start

Choose your platform:

- **Claude Code**: See [Claude Code Installation](INSTALLATION.md#claude-code-installation)
- **Cursor**: See [Cursor Installation](INSTALLATION.md#cursor-installation)
- **Cline**: See [Cline Installation](INSTALLATION.md#cline-installation)
- **OpenClaw**: See [OpenClaw Installation](integrations/openclaw/README.md)

Or follow the [5-Minute Quickstart Guide](QUICKSTART.md)

## Setu...