@mo7yw4ng/openape 1.0.3 → 1.0.5

package/skills/openape/SKILL.md

@@ -1,311 +1,115 @@
 ---
 name: openape
-description: How to use OpenApe CLI — automate CYCU iLearning (Moodle) tasks including course management, video progress tracking, quizzes, materials, grades, forums, announcements, and calendar
+description: "CYCU iLearning (Moodle): Manage courses, videos, quizzes, materials, grades, forums, announcements, and calendar."
+metadata:
+  openclaw:
+    category: "education"
+    requires:
+      bins:
+        - openape
+    cliHelp: "openape --help"
 ---
 
-# OpenApe CLI
+# openape
 
-Use the `openape` command to access CYCU iLearning (Moodle) platform. OpenApe provides automation for course management, video progress completion, quiz tracking, material downloads, grade viewing, forum discussions, announcements, and calendar events.
+> **PREREQUISITE:** Install and login first:
+>
+> ```bash
+> npm install -g @mo7yw4ng/openape
+> openape login
+> ```
 
-## Setup
-
-If `openape` is not installed:
-```bash
-npm install -g @mo7yw4ng/openape
-```
-
-If not authenticated, run:
-```bash
-openape login
-```
-A browser will open for Microsoft OAuth SSO. Complete MFA login manually.
-
-Session is saved to `.auth/storage-state.json` and persists between runs. If session expires, run `openape login` again.
-
-## Discovering Commands
-
-**Every command supports `--help` for full option details:**
 ```bash
-openape --help
-openape courses --help
-openape videos complete --help
+openape <command> [subcommand] [args] [flags]
 ```
 
-Add `--output json` to any command for machine-readable output. Use `--output csv` for spreadsheet format, `--output table` for human-readable tables.
-
-## Course Commands
-
-### Listing courses
-
-```bash
-# List in-progress courses (default)
-openape courses list
+## Commands
 
-# List all courses including past and future
-openape courses list --level all
+### courses — Course operations
 
-# List only past courses
-openape courses list --level past
+  - `list` — List enrolled courses. Flags: `--level in_progress|past|future|all`
+  - `info <course-id>` — Show detailed course information
+  - `progress <course-id>` — Show course completion progress
+  - `syllabus <course-id>` — Show course syllabus (from CMAP)
 
-# List only future courses
-openape courses list --level future
-```
+### videos — Video progress operations
 
-Course levels: `in_progress` (default), `past`, `future`, `all`.
+  - `list <course-id>` — List videos in a course. Flags: `--incomplete-only`
+  - `complete <course-id>` — Complete all videos in a course
+  - `complete-all` — Complete all incomplete videos across all courses. Flags: `--dry-run`
+  - `download <course-id>` — Download videos from a course. Flags: `--output-dir <path>`
 
-### Course information
+### quizzes — Quiz operations
 
-```bash
-# Get detailed course information
-openape courses info <course-id>
+  - `list <course-id>` — List incomplete quizzes in a course. Flags: `--all`
+  - `list-all` — List all incomplete quizzes across courses. Flags: `--level in_progress|all`
+  - `start <quiz-id>` — Start a new quiz attempt
+  - `info <attempt-id>` — Get quiz attempt data and questions. Flags: `--page <number>`
+  - `save <attempt-id> '<answers-json>'` — Save answers for a quiz attempt. Flags: `--submit`. JSON format: `[{"slot":1,"answer":"0"}]`. Multichoice: number, multichoices: `"0,2"`, shortanswer: text
 
-# Get course progress percentage
-openape courses progress <course-id>
+> **NEVER SUBMIT WITHOUT USER'S PERMISSION**, you have to make sure answer is saved before submitting.
 
-# Get course syllabus from CMAP (18-week schedule)
-openape courses syllabus <course-id>
-```
+### materials — Material/resource operations
 
-## Video Commands
-
-### Listing videos
-
-```bash
-# List all videos in a course
-openape videos list <course-id>
+  - `list-all` — List all materials across courses. Flags: `--level in_progress|all`
+  - `download <course-id>` — Download all materials from a course
+  - `download-all` — Download all materials from all courses. Flags: `--output-dir <path>`
+  - `complete <course-id>` — Mark all incomplete resources (non-video) as complete
+  - `complete-all` — Mark all incomplete resources across all in-progress courses
 
-# List only incomplete videos (browser mode only)
-openape videos list <course-id> --incomplete-only
-```
+### assignments — Assignment operations
 
-### Completing videos
+  - `list <course-id>` — List assignments in a course
+  - `list-all` — List all assignments across courses. Flags: `--level in_progress|all`
+  - `status <assignment-id>` — Check assignment submission status
+  - `submit <assignment-id>` — Submit an assignment. Flags: `--text <content>`, `--file-id <id>`
 
-```bash
-# Complete all incomplete videos in a course
-openape videos complete <course-id>
+### grades — Grade operations
 
-# Complete all incomplete videos across all courses
-openape videos complete-all
-```
+  - `summary` — Show grade summary across all courses
+  - `course <course-id>` — Show detailed grades for a course
 
-### Downloading videos
+### forums — Forum operations
 
-```bash
-# Download all videos from a course
-openape videos download <course-id>
+  - `list` — List forums from in-progress courses. Flags: `--level in_progress|all`
+  - `list-all` — List all forums across all courses
+  - `discussions <forum-id>` — List discussions in a forum
+  - `posts <discussion-id>` — Show posts in a discussion
+  - `post <forum-id> <subject> <message>` — Post a new discussion. Flags: `--subscribe`, `--pin`
+  - `reply <post-id> <subject> <message>` — Reply to a discussion post. Flags: `--parent-id <id>`
+  - `delete <post-id>` — Delete a forum post or discussion
 
-# Download only incomplete videos
-openape videos download <course-id> --incomplete-only
+### announcements — Announcement operations
 
-# Specify output directory (default: ./downloads/videos)
-openape videos download <course-id> --output-dir ./my-videos
-```
+  - `list-all` — List all announcements across courses. Flags: `--unread-only`
+  - `read <announcement-id>` — Read a specific announcement (full content)
 
-## Quiz Commands
+### calendar — Calendar operations
 
-### Listing quizzes
+  - `events` — List calendar events. Flags: `--course-id <id>`, `--events-after <date>`, `--events-before <date>`
+  - `export` — Export calendar events to file. Flags: `--format json|ics`, `--output <file>`
 
-```bash
-# List quizzes in a specific course
-openape quizzes list <course-id>
+### upload — File upload
 
-# List all quizzes across all courses
-openape quizzes list-all
+  - `file <file-path>` — Upload a file to Moodle draft area
 
-# List only in-progress course quizzes
-openape quizzes list-all --level in_progress
-```
+### skills — Skill management
 
-### Opening quizzes
-
-```bash
-# Open a quiz URL in browser (manual mode)
-openape quizzes open <quiz-url>
-```
-
-## Material Commands
-
-### Listing materials
-
-```bash
-# List all materials/resources across all courses
-openape materials list-all
-
-# List materials from in-progress courses only
-openape materials list-all --level in_progress
-```
-
-Materials include resources (PDFs, documents) and URLs (external links).
-
-### Downloading materials
-
-```bash
-# Download all materials from a specific course
-openape materials download <course-id>
-
-# Download all materials from all in-progress courses
-openape materials download-all
-
-# Download from all courses (including past)
-openape materials download-all --level all
-
-# Specify output directory (default: ./downloads)
-openape materials download-all --output-dir ./my-materials
-```
-
-## Grade Commands
-
-### Viewing grades
-
-```bash
-# Show grade summary across all courses
-openape grades summary
-
-# Show detailed grades for a specific course
-openape grades course <course-id>
-```
-
-## Forum Commands
-
-### Listing forums
-
-```bash
-# List forums from in-progress courses
-openape forums list
-
-# List all forums across all courses
-openape forums list-all
-
-# List forums from a specific course level
-openape forums list-all --level past
-```
-
-### Reading discussions
-
-```bash
-# List discussions in a forum (use cmid or instance ID)
-openape forums discussions <forum-id>
-
-# Show posts in a discussion
-openape forums posts <discussion-id>
-```
-
-## Announcement Commands
-
-### Listing announcements
-
-```bash
-# List all announcements across all courses
-openape announcements list-all
-
-# List only unread announcements
-openape announcements list-all --unread-only
-```
-
-### Reading announcements
-
-```bash
-# Read a specific announcement (shows full content)
-openape announcements read <announcement-id>
-```
-
-## Calendar Commands
-
-### Listing events
-
-```bash
-# List all calendar events
-openape calendar events
-
-# List events after a specific date
-openape calendar events --events-after 2026-03-01
-
-# List events before a specific date
-openape calendar events --events-before 2026-06-30
-
-# List events in a specific course
-openape calendar events --course-id <course-id>
-```
-
-### Exporting calendar
-
-```bash
-# Export calendar events to file
-openape calendar export
-
-# Specify output file (default: calendar_events.json)
-openape calendar export --output my-calendar.json
-
-# Export as ICS format for calendar apps
-openape calendar export --format ics --output my-calendar.ics
-```
+  - `install [platform]` — Install OpenApe skill to an agent platform (claude, codex, opencode)
+  - `show` — Print the raw SKILL.md content
 
 ## Output Formats
 
-All commands support `--output` option:
-- `json` (default) - Machine-readable JSON
-- `csv` - Comma-separated values for spreadsheets
-- `table` - Human-readable table format
-- `silent` - Suppress output (useful for automation)
-
-Global options:
-- `--verbose` - Enable debug logging
-- `--silent` - Suppress all log output (JSON only)
-- `--headed` - Run browser in visible mode (for debugging)
-
-## Example Workflows
+All commands support `--output`: `json` (default), `csv`, `table`, `silent`
 
-**Check daily progress:** See what's due and what's incomplete.
-```bash
-openape courses list --level in_progress
-openape videos list <course-id>
-openape quizzes list-all
-openape announcements list-all --unread-only
-```
-
-**Auto-complete videos:** Complete all incomplete videos across courses.
-```bash
-# First, dry-run to see what will be completed
-openape videos complete-all --dry-run
+Global flags: `--verbose`, `--headed`, `--session <path>`
 
-# Then actually complete them
-openape videos complete-all
-```
-
-**Download all materials:** Get all course materials for offline study.
-```bash
-openape materials download-all --output-dir ./semester-materials
-```
-
-**Check grades and progress:** See how you're doing in all courses.
-```bash
-openape grades summary
-openape courses progress <course-id>
-openape courses syllabus <course-id>
-```
-
-**Review discussions:** Catch up on forum activity.
-```bash
-openape forums list --level in_progress
-openape forums list-all
-openape forums discussions <forum-id>
-openape forums posts <discussion-id>
-```
+## Discovering Commands
 
-**Plan your week:** Check upcoming events and deadlines.
 ```bash
-openape calendar events --events-after 2026-03-21 --events-before 2026-03-28
-openape calendar export --format ics --output week.ics
-```
+# Browse all commands
+openape --help
 
-**Bulk operations:** Complete videos and download materials across all courses.
-```bash
-openape videos complete-all
-openape materials download-all --level in_progress
+# Inspect a command's subcommands and options
+openape <command> --help
 ```
-
-## Tips
-
-- Use `--level in_progress` (default) to focus on active courses
-- Use `--output json` for scripting and automation
-- Use `--output table` for human-readable output