Source profileQuality 81/100Review permissions
xuzhougeng/wisp-science/skills/self-awareness/SKILL.md
self-awareness
Wisp-science's actual agent tool surface and runtime boundaries. Load this when deciding which Wisp tool can perform a task, checking whether Python can reach agent or desktop capabilities, choosing between interactive analysis and persisted Runs, or answering questions about delegation, images, skills, memory, artifacts, lineage, credentials, session history, and other self-introspection capabilities.
- Source repository stars
- 560
- Declared platforms
- 0
- Static risk flags
- 1
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
Use only tools advertised in the current conversation. Wisp exposes agent and desktop capabilities as explicit tools; do not assume that an SDK documented by another application also exists here. Some tools are conditional on the desktop session, project settings, execution cont…
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
Source-detected install commandSource
npx skills add https://github.com/xuzhougeng/wisp-science --skill "skills/self-awareness"Safe inspection promptEditorial
Inspect the Agent Skill "self-awareness" from https://github.com/xuzhougeng/wisp-science/blob/95d2c13d1665d46a388b5bdc998dcce0d5ec2eee/skills/self-awareness/SKILL.md at commit 95d2c13d1665d46a388b5bdc998dcce0d5ec2eee. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
Python and R boundary
Use python for persistent Python analysis and r for persistent R analysis. Their variables and imports persist per project and execution context. Pass a contextid such as local, ssh:, or wsl: when the work must run somewhere other than the default local context.
Use python for persistent Python analysis and r for persistent R analysis. Their variables and imports persist per project and execution context. Pass a contextid such as local, ssh:, or wsl: when the work must run some…The Python worker initializes an ordinary namespace with common standard-library modules and any available convenience packages. It does not inject a Wisp control-plane object. Code executed with python therefore cannot… - 02
Capability reference
Review the “Capability reference” section in the pinned source before continuing.
Review and apply the “Capability reference” source section. - 03
Choosing the right execution path
1. Use python or r for interactive analysis whose next step depends on the computed result. 2. Use runincontext for persisted, recoverable, or long-running work. Use monitorrun once when the result is needed in the current task, or return the Run id for fire-and-forget work. 3.…
Use python or r for interactive analysis whose next step depends on theUse runincontext for persisted, recoverable, or long-running work. UseUse explore when codebase understanding requires more than a couple of
Permission review
Static risk signals and limitations
Runs scripts
The documentation asks the agent to run terminal commands or scripts.
| Run a short command | `shell` | Use for bounded foreground commands, not as a long-running job manager. |Evidence record
Why each signal appears
EvidenceSourceComputedTestedEditorial
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 81/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 560 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- xuzhougeng/wisp-science
- Skill path
- skills/self-awareness/SKILL.md
- Commit
- 95d2c13d1665d46a388b5bdc998dcce0d5ec2eee
- License
- AGPL-3.0
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
Self-awareness — Wisp's actual capabilities
Use only tools advertised in the current conversation. Wisp exposes agent and desktop capabilities as explicit tools; do not assume that an SDK documented by another application also exists here. Some tools are conditional on the desktop session, project settings, execution context, or capability grants. If a tool is not advertised, treat it as unavailable.
Python and R boundary
Use python for persistent Python analysis and r for persistent R analysis.
Their variables and imports persist per project and execution context. Pass a
context_id such as local, ssh:<alias>, or wsl:<distro> when the work must
run somewhere other than the default local context.
The Python worker initializes an ordinary namespace with common standard-library
modules and any available convenience packages. It does not inject a Wisp
control-plane object. Code executed with python therefore cannot directly call
the agent model, spawn Agents, submit or monitor Runs, inspect Wisp credentials,
or query internal project/session metadata. Leave the Python cell and call the
corresponding Wisp tool instead.
Capability reference
| Need | Wisp interface | Availability and boundary |
|---|---|---|
| Read, create, or patch project files | read, write, edit | Operate on normal filesystem paths within the granted workspace. |
| Find files or text | search, grep | Use before broad manual inspection. |
| Run a short command | shell | Use for bounded foreground commands, not as a long-running job manager. |
| Interactive Python or R analysis | python, r | Persistent per project and execution context; no injected control-plane SDK. |
| Inspect a local image | view_image | Explicit tool call for a supported local image; this is not a Python method. |
| Track a multi-step plan | update_plan | Update task progress when a plan materially helps. |
| Present the completed result | attempt_completion | Wisp's normal completion path; there is no separate structured-output submission SDK. |
| Discover and load workflow guidance | search_skills, use_skill | Search by task/domain, then load the exact returned skill name. |
| Search or save durable notes | search_memory, append_memory | Available only when project memory is enabled; memory is not a transcript or telemetry database. |
| Delegate multi-file codebase reading | explore | Read-only sub-Agent with its own context and read/grep/search access. |
| Delegate general bounded tasks | delegate_tasks | Desktop-only and capability-gated. Use it only when its schema is advertised; it is not callable from Python. |
| Read a truncated delegated result | get_delegated_result | Desktop-only and available with delegation. Use only when the compact result lacks necessary detail. |
| Submit long-running work | run_in_context | Persist a Run in local, ssh:<alias>, or wsl:<distro>. Prefer this over extending shell timeouts. |
| Read one Run snapshot | get_run | Call once for an immediate status check; never poll it in a loop. |
| Wait for a Run | monitor_run | Call exactly once with the Run id. Wisp waits without repeated model calls. |
| Cancel a Run | cancel_run | Request cancellation through the persisted Run lifecycle. |
| Record project research objects | research_graph | Desktop-only. Record data assets, papers, or decisions and link existing graph nodes; it is not a generic artifact browser. |
| Create a specialist | save_specialist | Desktop-only and create-only. Editing and deletion remain in Settings. |
| Make an extra model call from Python | Not available | Continue through the normal agent turn. For bounded delegated work, use explore or advertised delegate_tasks. |
| Resolve artifact ids to paths, list a generic artifact store, or inspect lineage | Not available | Use ordinary project paths plus read/search/grep. Do not invent artifact ids, version ids, or lineage records. Run output registration is limited to the explicit output_specs contract of run_in_context. |
| Read credentials from Python or an agent tool | Not available | Wisp keeps secrets outside SQLite in its keyring path; no credential accessor is exposed to the agent. |
| Query frames, token/cost accounting, tool-call history, or the internal metadata DB | Not available | Use only conversation context and tool results already provided. Do not claim access to hidden session tables or telemetry. |
Choosing the right execution path
- Use
pythonorrfor interactive analysis whose next step depends on the computed result. - Use
run_in_contextfor persisted, recoverable, or long-running work. Usemonitor_runonce when the result is needed in the current task, or return the Run id for fire-and-forget work. - Use
explorewhen codebase understanding requires more than a couple of reads. Usedelegate_tasksonly when desktop delegation is currently advertised and the work benefits from independent or parallel Agents. - Use ordinary project files for inputs and outputs. Never fabricate an artifact registry, lineage API, credential API, session database, or Python-side bridge for a capability that is not present.
For SSH-direct details, load remote-compute-ssh; its Run workflow and current
limitations are the authoritative Wisp contract.
Alternatives
Compare before choosing
Computed 9831,966
K-Dense-AI/scientific-agent-skills
dask
Distributed computing for larger-than-RAM pandas/NumPy workflows. Use when you need to scale existing pandas/NumPy code beyond memory or across clusters. Best for parallel file processing, distributed ML, integration with existing pandas code. For out-of-core analytics on single machine use vaex; for in-memory speed use polars.
Computed 9831,966
K-Dense-AI/scientific-agent-skills
neurokit2
Use NeuroKit2 to build or audit reproducible research workflows for physiological time-series preprocessing, event/interval analysis, multimodal alignment, variability, and complexity. Trigger when code imports neurokit2 or needs its current APIs, schemas, and method-aware validation—not for diagnosis or device validation.
Computed 9737,126
github/awesome-copilot
geofeed-tuner
Use this skill whenever the user mentions IP geolocation feeds, RFC 8805, geofeeds, or wants help creating, tuning, validating, or publishing a self-published IP geolocation feed in CSV format. Intended user audience is a network operator, ISP, mobile carrier, cloud provider, hosting company, IXP, or satellite provider asking about IP geolocation accuracy, or geofeed authoring best practices. Helps create, refine, and improve CSV-format IP geolocation feeds with opinionated recommendations beyon
Computed 9731,966
K-Dense-AI/scientific-agent-skills
biopython
Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.