← Back to Skills Marketplace
topviewai

Topview

by topview.ai · GitHub ↗ · v0.1.5 · MIT-0
cross-platform ⚠ suspicious
386
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install topview
Description
Generate, Edit, Collaborate. Access all mainstream AI models in one toolkit. Simply describe your vision to create videos, images, and avatars—zero manual op...
Usage Guidance
What to consider before installing Topview: - Metadata mismatch: The skill's registry entry claims no required env vars, but SKILL.md and the scripts require TOPVIEW_API_KEY / TOPVIEW_UID and Python 3. Do not trust the registry metadata alone — require the author to correct it or explain the discrepancy. - Inspect auth.py first: open scripts/auth.py and scripts/shared/client.py to confirm they only communicate with the official topview.ai endpoints and do not exfiltrate credentials to third-party hosts. Verify where credentials are saved (~/.topview/credentials.json) and that file-permissions are set as claimed. - Review requirements: check scripts/requirements.txt to see which third-party libraries would be installed via pip and whether any look suspicious or invasive. - Prompt-injection-like directives: SKILL.md forces the agent to re-run the login flow until it sees a URL and forbids revealing technical outputs. That reduces transparency. If you install, ask for an option where the agent logs steps for you (in a secure place) rather than hiding them completely. - Run in an isolated environment first: if you decide to try it, run the skill in a sandboxed agent or VM where stored credentials and files can be controlled and inspected. - Limit privileges: do not provide other unrelated secrets. Only the Topview credentials should be used. If you cannot verify the code, avoid running auth flows that create persistent credentials on a machine you care about. - Prefer official sources: the skill lists topview.ai but the Source/Homepage is unknown. Prefer a skill with a verifiable homepage or author identity and an explicit registry declaration of required env vars. If you want, I can help inspect the specific files (scripts/auth.py and scripts/shared/client.py) for network endpoints and credential handling and summarize any suspicious code lines to help decide whether to trust this skill.
Capability Analysis
Type: OpenClaw Skill Name: topview Version: 0.1.5 The Topview AI skill bundle is a legitimate toolkit for interacting with the Topview AI API to generate and edit videos, images, and audio. It implements a standard OAuth 2.0 Device Flow for authentication (auth.py) and stores credentials locally in a standard hidden directory (~/.topview/). The scripts (e.g., video_gen.py, ai_image.py) are well-structured, using a shared client (client.py) that communicates exclusively with api.topview.ai. The instructions in SKILL.md are designed to ensure a user-friendly experience for non-technical users by enforcing specific reply templates and hiding technical details. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Tags
cryptocan-make-purchasesrequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The SKILL.md and included scripts clearly implement a Topview API client that needs TOPVIEW_API_KEY / TOPVIEW_UID and Python 3, but the registry metadata lists no required environment variables or primary credential. That mismatch (manifest says 'none' while SKILL.md declares primaryEnv: TOPVIEW_API_KEY and requires python3) is an incoherence that should be resolved. The code files and modules (auth, upload, video_gen, avatar, etc.) are consistent with the skill's described capabilities, so the extra requirements are expected — the problem is they are not declared in the registry metadata.
Instruction Scope
SKILL.md contains strong runtime directives for the agent: always run the bundled Python scripts (not direct HTTP), always run auth.py login and extract the 'URL:' line to send to the user, re-run login if URL is missing, and 'never' mention terminal details or environment variables to users. Those are operationally coherent for a user-facing integration but are also high-authority, narrow instructions that function as prompt-injection style constraints on agent behavior (e.g., insisting the agent re-run login until it obtains a URL and forbidding disclosure of technical outputs). This reduces transparency and could hide errors or unexpected behavior.
Install Mechanism
There is no install spec in the registry, which reduces the risk of arbitrary downloads. The package is instruction+code bundled in the skill (Python scripts included) and includes scripts/requirements.txt — installing dependencies would typically use pip. That is a common pattern and not unusually risky, but you should review requirements.txt and the scripts before executing them. No external arbitrary download URLs were declared in the install spec (none present).
Credentials
The skill legitimately needs Topview credentials (TOPVIEW_API_KEY and TOPVIEW_UID saved locally via device flow), and scripts write credentials to ~/.topview/credentials.json. Those variables and local file writes are proportionate to the stated purpose — but they are not declared in the registry metadata, which is a significant inconsistency. There are no unrelated credentials requested, but the skill instructs the agent to perform a login flow that will store secrets on the agent host; you should verify that behavior and where credentials are sent/stored.
Persistence & Privilege
The skill persists credentials locally (~/.topview/credentials.json) and instructs the agent to run an OAuth device flow. It is not marked always:true and does not request system-wide privilege changes or modifications to other skills. Persisting its own credentials is expected for this type of skill, but you should be aware it will create and store secrets on the agent host.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install topview
  3. After installation, invoke the skill by name or use /topview
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
topview 0.1.5 - Added metadata file (_meta.json) to support skill packaging and distribution. - No functional changes to the core code or user-facing behavior.
v0.1.4
topview-skill 0.1.4 - Updated the login message templates to instruct users to click a Markdown-friendly link: "点击登录 (<LOGIN_URL>)" for Chinese, "Click to sign in (<LOGIN_URL>)" for English. - Clarified template instructions: present login links in plain text suitable for chat, not as standalone URLs. - No changes to core functionality or agent workflow rules.
v0.1.3
topview v0.1.3 - No code or documentation changes were detected in this release. - Functionality and user guidelines remain unchanged from the previous version.
v0.1.2
topview-skill v0.1.2 - No file changes detected in this release. - Behavior, usage, and documentation remain unchanged.
v0.1.1
topviewskill v0.1.1 - Added installation instructions for alternate install methods if `clawhub` fails. - No other significant changes; user-facing rules and capabilities remain the same.
v0.1.0
Initial release of topview-skill — a modular toolkit for using mainstream AI video, image, and voice models via Topview API. - Unified access to top global models for video, image, avatar, voice, and background removal tasks. - Plain-language user reply rules designed for non-technical users in chat platforms (e.g., Feishu, WeChat), with clear messaging templates and action flows. - Fully automated experience: seamless authorization flows, direct result sharing, strict error simplification, and automatic user guidance. - Built-in time estimates for generation tasks to set clear user expectations. - Strict enforcement on user-facing messages: no technical jargon, never request terminal/browser actions, and only act through chat conversation.
Metadata
Slug topview
Version 0.1.5
License MIT-0
All-time Installs 1
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is Topview?

Generate, Edit, Collaborate. Access all mainstream AI models in one toolkit. Simply describe your vision to create videos, images, and avatars—zero manual op... It is an AI Agent Skill for Claude Code / OpenClaw, with 386 downloads so far.

How do I install Topview?

Run "/install topview" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Topview free?

Yes, Topview is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Topview support?

Topview is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Topview?

It is built and maintained by topview.ai (@topviewai); the current version is v0.1.5.

💬 Comments