{"id":99250,"plugin_id":"plugin_asdk_app_6aee5ea561e0819197c342b51dddf556","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-16T18:17:07.514Z","digest":"9397a64becd7ad3e15c9589cd97d63db0e3d03f79bed3e3ae97709fe2814fbba","against":null,"payload":{"description":"How to answer questions about an organization's OasisLMS data with the OasisLMS Nexus tools, including which tool to choose, date ranges, filters, and pagination.","included_files":[],"name":"get-started","skill_md_contents":"---\nname: get-started\ndescription: How to answer questions about an organization's OasisLMS data with the OasisLMS Nexus tools, including which tool to choose, date ranges, filters, and pagination.\n---\n\n# Getting started with OasisLMS Nexus\n\nOasisLMS Nexus gives read-only access to the signed-in user's own OasisLMS organization. It can't create, change, or delete LMS data. If the user asks for a change (for example enrolling, deleting, or editing users or courses), explain that Nexus is read-only and that the change has to be made in OasisLMS itself.\n\n## Choosing a tool\n\n- **Totals, trends, and rankings:** use the `get_*_analytics` tools first. They return summary metrics, period series, and top lists without listing every record.\n  - Users and registrations: `get_user_analytics`\n  - Logins and traffic: `get_user_login_analytics`\n  - Enrollments, progress, and completion: `get_user_progress_analytics`\n  - Content engagement: `get_content_engagement_analytics`\n  - Courses: `get_course_analytics`\n  - Purchases and revenue: `get_course_purchase_analytics`\n  - Credit claims: `get_user_credit_claim_analytics`\n- **Specific records:** use the `search_*` tools, such as `search_users`, `search_courses`, `search_exams`, `search_user_progress`, and `search_course_purchases`.\n- **Category filters:** before filtering on a category such as membership level, course type, or completion status, call `get_dimension_values` to get the exact labels used in this organization instead of guessing.\n\n## Dates\n\n- Analytics tools accept `DateFrom` and `DateTo` as `yyyy-MM-dd` or an RFC 3339 date-time. `DateFrom` is inclusive and `DateTo` is exclusive, so \"March 2026\" is `DateFrom=2026-03-01`, `DateTo=2026-04-01`.\n- Convert relative phrases such as \"last month\" or \"this year\" into explicit dates.\n\n## Large results\n\n- To answer \"how many\" questions with a search tool, set `CountOnly=true`.\n- Search tools return up to 200 records per call. Use `Limit` and `Offset` to page through more, and tell the user when a result was truncated.\n- On analytics tools, use `Sections` to request only the parts you need.\n\n## When data is unavailable\n\nIf a result has `IsAvailable` set to false, the organization's LMS doesn't have that data. Tell the user which data is missing instead of guessing.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}