Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions marketplaces/default.json
Original file line number Diff line number Diff line change
Expand Up @@ -472,6 +472,19 @@
"sample"
]
},
{
"name": "campus-copilot-current-view-triage",
"source": "./campus-copilot-current-view-triage",
"description": "Turn a Campus Copilot snapshot or current-view export into one plain-language what-to-do-first answer for a student.",
"category": "productivity",
"keywords": [
"campus-copilot",
"student",
"triage",
"snapshot",
"read-only"
]
},
{
"name": "magic-test",
"source": "./plugins/magic-test",
Expand All @@ -497,6 +510,19 @@
"openhands",
"slash-command"
]
},
{
"name": "sourceharbor-watchlist-briefing",
"source": "./sourceharbor-watchlist-briefing",
"description": "Use SourceHarbor watchlists and briefing payloads to answer one operator question with evidence and a concrete next action.",
"category": "productivity",
"keywords": [
"sourceharbor",
"watchlist",
"briefing",
"mcp",
"operator"
]
}
]
}
39 changes: 39 additions & 0 deletions skills/campus-copilot-current-view-triage/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Current View Triage

This skill is the compact read-only triage card for Campus Copilot.

It is designed to work like a lightweight plugin bundle:

- one skill prompt that tells the agent what job to do
- one install/config pack that tells the operator how to connect the runtime
- one capability map that explains which Campus Copilot tools are exposed
- one demo path that shows the shortest first-success flow
- one troubleshooting page that explains where the first failures usually live
- one manifest so the folder can travel into review-driven skill registries

Use it when you want the shortest truthful answer to:

- what should the student do first right now

## What this packet includes

- `SKILL.md`
- the agent-facing triage workflow
- `README.md`
- the human-facing packet overview
- `manifest.yaml`
- registry-style metadata for host skill registries
- `references/README.md`
- the local index for every supporting file
- `references/INSTALL.md`
- install and host wiring guidance
- `references/OPENHANDS_MCP_CONFIG.json`
- a ready-to-edit `mcpServers` snippet
- `references/OPENCLAW_MCP_CONFIG.json`
- a ready-to-edit `mcp.servers` snippet
- `references/CAPABILITIES.md`
- the read-only Campus Copilot tool surface
- `references/DEMO.md`
- the first-success walkthrough and expected output shape
- `references/TROUBLESHOOTING.md`
- the first places to check when setup or triage fails
76 changes: 76 additions & 0 deletions skills/campus-copilot-current-view-triage/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
name: current-view-triage
description: Turn one Campus Copilot snapshot or MCP-backed current view into a plain-language what-to-do-first answer for a student.
---

# Current View Triage

Use this skill when you want one plain-language answer to the question:

- what should the student do first right now

Treat it like a **read-only triage plugin card** over one imported workspace snapshot or one local BFF-backed current view, not a live-browser playbook.

## What this skill teaches

- how to prefer read-only Campus Copilot MCP or snapshot surfaces first
- how to turn Focus Queue and recent changes into one concrete next action
- how to answer with evidence and trust gaps instead of inventing missing facts

## Runtime you need

- one imported snapshot path or one current-view export
- or one connected Campus Copilot MCP server
- use `references/INSTALL.md` if the MCP server still needs to be connected
- use `references/DEMO.md` for the first-success walkthrough
- use `references/TROUBLESHOOTING.md` if setup or input truth is still unclear

## Exposed MCP abilities

- `campus_health`
- `providers_status`
- `ask_campus_copilot`
- the four `*_snapshot_view` tools
- `export_snapshot_artifact`

Use `references/CAPABILITIES.md` when you need the quick map.

## Inputs

- `SNAPSHOT_PATH` or one current-view export path
- optional `QUESTION`
- optional `MCP_STATUS`

## Steps

1. Decide whether MCP-backed current view is available; otherwise stay on the imported snapshot/current-view export.
2. Build a short workspace summary from the strongest available read-only surface.
3. Inspect the top Focus Queue items and recent updates.
4. If a question is provided, use the cited-answer path instead of guessing.
5. Return:
- `top_action`
- `why_now`
- `evidence_used`
- `trust_gaps`

## Good fit

- Codex or Claude-style first-pass triage over a snapshot
- OpenClaw-style local consumers that need one short "what now" brief
- any read-only triage workflow that needs one trustworthy next action without reopening browser automation

## Hard boundary

- stay on imported snapshots or the thin local BFF
- do not claim live browser/session truth from snapshot-only evidence
- do not mutate site state

## Companion references

- `references/README.md`
- `references/INSTALL.md`
- `references/OPENHANDS_MCP_CONFIG.json`
- `references/OPENCLAW_MCP_CONFIG.json`
- `references/CAPABILITIES.md`
- `references/DEMO.md`
- `references/TROUBLESHOOTING.md`
41 changes: 41 additions & 0 deletions skills/campus-copilot-current-view-triage/manifest.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
schema_version: 1
artifact: public-skill-listing-manifest

skill:
name: current-view-triage
display_name: Current View Triage
version: 1.0.0
entrypoint: SKILL.md
package_shape: skill-folder

registry_targets:
clawhub:
status: listed-live
package_shape: skill-folder
listing_url: https://www.clawhub.ai/skills/current-view-triage
submit_via: clawhub publish . --slug current-view-triage --name "Current View Triage" --version 1.0.0 --tags campus,student,triage,mcp,read-only
openhands-extensions:
status: review-pending
package_shape: skill-folder
submission_url: https://github.com/OpenHands/extensions/pull/155
submit_via: submit this folder as skills/current-view-triage/ in OpenHands/extensions

boundaries:
product_identity: Read-only student triage over Campus Copilot snapshots or current-view MCP output.
canonical_repo_version: 0.1.0
official_listing_state: clawhub-live-openhands-review-pending
not_claimed:
- No live OpenHands/extensions listing exists yet
- No live browser-session truth is claimed from snapshot-only evidence
- No hosted Campus Copilot service is claimed

pair_with:
- SKILL.md
- README.md
- references/README.md
- references/INSTALL.md
- references/OPENHANDS_MCP_CONFIG.json
- references/OPENCLAW_MCP_CONFIG.json
- references/CAPABILITIES.md
- references/DEMO.md
- references/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Campus Copilot Capability Map

This skill intentionally stays on the read-only Campus Copilot surfaces.

## Core MCP tools

- `campus_health`
- `providers_status`
- `ask_campus_copilot`
- `canvas_snapshot_view`
- `gradescope_snapshot_view`
- `edstem_snapshot_view`
- `myuw_snapshot_view`
- `export_snapshot_artifact`

## Best default order

1. `campus_health`
2. one or more `*_snapshot_view` tools
3. `ask_campus_copilot` if a question exists
4. `export_snapshot_artifact` only if the operator needs a saved proof artifact
23 changes: 23 additions & 0 deletions skills/campus-copilot-current-view-triage/references/DEMO.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# OpenHands / OpenClaw Demo Walkthrough

This is the shortest concrete demo you can run to prove the skill is doing real
triage work instead of only existing as prose.

## Demo prompt

Use Campus Copilot to tell the student what to do first right now. Start with
`campus_health`. Then inspect the strongest available snapshot/current-view
surface. If a student question exists, answer it through `ask_campus_copilot`.
Return `top_action`, `why_now`, `evidence_used`, and `trust_gaps`.

## Expected tool sequence

1. `campus_health`
2. one or more `*_snapshot_view` tools
3. optionally `ask_campus_copilot`

## Visible success criteria

- the agent names one concrete first action
- the answer cites the Focus Queue or snapshot surface instead of guessing
- the boundary stays read-only and snapshot-aware
36 changes: 36 additions & 0 deletions skills/campus-copilot-current-view-triage/references/INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Campus Copilot MCP Setup

Use this when the host runtime does not already have Campus Copilot MCP
connected.

## Quickest local setup

1. Clone the public repo:

```bash
git clone https://github.com/xiaojiou176-open/campus-copilot.git
cd campus-copilot
pnpm install
```

2. Build the read-only MCP server:

```bash
pnpm --filter @campus-copilot/mcp-server build
```

3. Start the MCP server directly:

```bash
pnpm --filter @campus-copilot/mcp-server start
```

4. Before loading the host config snippets in this folder, replace
`/ABSOLUTE/PATH/TO/campus-copilot` with the real path to your local clone.

## If your host supports MCP Bundles

Campus Copilot also ships a release-hosted MCP bundle:

- registry name: `io.github.xiaojiou176-open/campus-copilot-mcp`
- release asset: `https://github.com/xiaojiou176-open/campus-copilot/releases/download/v0.1.0/campus-copilot-mcp-0.1.0.mcpb`
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"mcp": {
"servers": {
"campus-copilot": {
"command": "pnpm",
"args": ["--filter", "@campus-copilot/mcp-server", "start"],
"cwd": "/ABSOLUTE/PATH/TO/campus-copilot"
}
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"mcpServers": {
"campus-copilot": {
"command": "pnpm",
"args": ["--filter", "@campus-copilot/mcp-server", "start"],
"cwd": "/ABSOLUTE/PATH/TO/campus-copilot"
}
}
}
19 changes: 19 additions & 0 deletions skills/campus-copilot-current-view-triage/references/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Campus Copilot Skill References

This directory keeps the practical material that a reviewer or agent needs
without depending on repo-root docs.

## Included references

- `INSTALL.md`
- install the Campus Copilot MCP server and wire it into a host
- `OPENHANDS_MCP_CONFIG.json`
- a ready-to-edit `mcpServers` snippet
- `OPENCLAW_MCP_CONFIG.json`
- a ready-to-edit `mcp.servers` snippet
- `CAPABILITIES.md`
- the read-only Campus Copilot tool surface and first-use order
- `DEMO.md`
- the shortest first-success walkthrough and expected output shape
- `TROUBLESHOOTING.md`
- the first places to check when setup or triage fails
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Campus Copilot Troubleshooting

Use this page when the packet looks right on paper but the first triage answer
still fails.

## 1. The MCP server does not launch

Check these first:

- `pnpm install` finished in the repo root
- the host config points at the right `cwd`
- the MCP server was built before you tried to start it

If launch still fails, report it as a local MCP setup problem instead of
pretending the triage lane is ready.

## 2. Only snapshot/current-view files are available

That is allowed. Stay on the snapshot path and make the trust gap explicit.
Do not claim live browser or session truth.

## 3. The question is broader than one read-only next action

Stop after the triage answer and tell the user what extra surface is missing.
This packet is for “what should I do first right now,” not for broad workflow
automation.
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Current View Triage Capability Map

This skill only needs the read-only Campus Copilot surfaces.

## Core tools

- `campus_health`
- `providers_status`
- `ask_campus_copilot`
- `canvas_snapshot_view`
- `gradescope_snapshot_view`
- `edstem_snapshot_view`
- `myuw_snapshot_view`
- `export_snapshot_artifact`

## Best default order

1. health
2. one or more snapshot-view tools
3. ask, if there is an explicit question
4. export only if the operator needs a saved proof artifact
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Example Output

```text
Top action: Finish the Canvas item due tomorrow before the lower-priority backlog.
Why now: It is the nearest due item and it blocks the rest of the week's plan.
Evidence used: Focus Queue rank 1, recent current-view changes, and the Canvas snapshot slice.
Trust gaps: This answer is snapshot-scoped and does not claim live browser truth.
```
Loading
Loading