Run any Skill in Manus with one click

debugging-operations

Stars0

Forks0

UpdatedApril 10, 2026 at 21:18

Diagnose TMET runtime, queue, scraping, upload, and file-artifact issues. Use when investigating failing routes, stuck jobs, broken Browserless/SUAP flows, malformed CSV or JSON outputs, Docker problems, or test regressions.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

werlang

werlang/tmet

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	debugging-operations
description	Diagnose TMET runtime, queue, scraping, upload, and file-artifact issues. Use when investigating failing routes, stuck jobs, broken Browserless/SUAP flows, malformed CSV or JSON outputs, Docker problems, or test regressions.

Debugging and Operations (TMET)

Use this skill to

Triage backend failures in routes/, models/, and helpers/.
Investigate queue lifecycle issues in helpers/queue.js and /api/jobs/:jobId.
Diagnose broken pipeline artifacts in files/*.json and files/*.csv.

Fast triage flow

Reproduce with the smallest route call, test file, or model method that still shows the problem.
Check docker compose logs -f node and the closest failing test.
Confirm queue state through /api/jobs/:jobId when the bug involves async work.
Inspect the specific generated file involved instead of assuming the wrong stage failed.
Verify environment variables only for the integrations that the failing flow actually touches.

Common hotspots

helpers/scraper.js + config/suap-config.js for SUAP login/session issues
helpers/timetables.js for EduPage extraction issues
helpers/moodle-uploader.js for Moodle upload failures
helpers/chat-assist.js + models/AIMatch.js for AI matching failures
helpers/queue.js when jobs appear stuck, missing, or prematurely cleaned up

Commands

docker compose ps
docker compose logs -f node
docker compose exec node npm test -- tests/routes/suapRoute.test.js
docker compose exec node npm test -- tests/helpers/queue.test.js

Out of scope

Incident tooling outside this repository.
Message brokers, worker pools, or persisted job systems that TMET does not implement.

More from this repository

same repository

api-development

werlang/tmet

Build and update TMET backend APIs in Express. Use when changing handlers in routes/*.js, file-backed business logic in models/*.js, queue-driven async jobs, scraping/upload integrations in helpers/*.js, or response contracts under /api/matches, /api/moodle, /api/suap, /api/ai, and /api/jobs.

2026-04-100

api-functional-testing

werlang/tmet

Validate TMET API contracts and multi-step flows, especially async job polling, generated file artifacts, and extraction -> matching -> enrollment workflows. Use when verifying behavior across routes, models, helpers, queue progress, and persisted outputs in files/.

2026-04-100

api-unit-testing-jest

werlang/tmet

Write and maintain TMET Jest + Supertest tests. Use when changing routes, models, helpers, queue logic, file parsing, or API contracts and you need focused coverage under tests/routes, tests/models, tests/helpers, or tests/integration.

2026-04-100

docker-deployment

werlang/tmet

Run, debug, and validate TMET with Docker Compose. Use when bringing up the current node + chrome stack, checking logs, running tests in-container, or confirming Browserless-based scraping and upload workflows.

2026-04-100

pipeline-workflow

werlang/tmet

Operate and evolve the TMET extraction to matching to CSV to Moodle-upload pipeline. Use when changing or debugging EduPage extraction, SUAP scraping, manual course or student queues, subject matching, AI matching, student/professor extraction, generated files in files/, or end-to-end operator workflow behavior.

2026-04-100

web-frontend

werlang/tmet

Implement and maintain the TMET static frontend in public/. Use when changing public/index.html, browser-native ES modules in public/js/, UI components, section controllers, or request/model adapters that drive the pipeline, matching, manual queue, and students/professors workflows.

2026-04-100

name	debugging-operations
description	Diagnose TMET runtime, queue, scraping, upload, and file-artifact issues. Use when investigating failing routes, stuck jobs, broken Browserless/SUAP flows, malformed CSV or JSON outputs, Docker problems, or test regressions.

Debugging and Operations (TMET)

Use this skill to

Triage backend failures in routes/, models/, and helpers/.
Investigate queue lifecycle issues in helpers/queue.js and /api/jobs/:jobId.
Diagnose broken pipeline artifacts in files/*.json and files/*.csv.

Fast triage flow

Reproduce with the smallest route call, test file, or model method that still shows the problem.
Check docker compose logs -f node and the closest failing test.
Confirm queue state through /api/jobs/:jobId when the bug involves async work.
Inspect the specific generated file involved instead of assuming the wrong stage failed.
Verify environment variables only for the integrations that the failing flow actually touches.

Common hotspots

helpers/scraper.js + config/suap-config.js for SUAP login/session issues
helpers/timetables.js for EduPage extraction issues
helpers/moodle-uploader.js for Moodle upload failures
helpers/chat-assist.js + models/AIMatch.js for AI matching failures
helpers/queue.js when jobs appear stuck, missing, or prematurely cleaned up

Commands

docker compose ps
docker compose logs -f node
docker compose exec node npm test -- tests/routes/suapRoute.test.js
docker compose exec node npm test -- tests/helpers/queue.test.js

Out of scope

Incident tooling outside this repository.
Message brokers, worker pools, or persisted job systems that TMET does not implement.