← 返回 Skills 市场
dagmawibabi

Addis Assistant

作者 dagmawibabi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2163
总下载
1
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install addis-assistant-stt
功能描述
Provides Speech-to-Text (STT) and text Translation using the Addis Assistant API (api.addisassistant.com). Use when the user needs to convert an audio file to text (specifically Amharic), or translate text between languages (e.g., Amharic to English). Requires 'x-api-key'.
使用说明 (SKILL.md)

Addis Assistant

Overview

This skill enables the use of the Addis Assistant API for both Speech-to-Text (STT) and text Translation.

Using This Skill

This skill provides two primary functions:

  1. Speech-to-Text (STT): Convert an audio file (e.g., Amharic) into text.
  2. Translation: Translate text from a source language to a target language.

Authentication

Both functions require an x-api-key. This key should be provided as an argument to the respective scripts.

STT Function

  • Endpoint: api.addisassistant.com/api/v2/stt
  • Method: POST
  • Parameters:
    • audio: Path to the audio file (e.g., "@/path/to/file")
    • request_data: JSON string with "language_code": "am" (Amharic is the default and only supported language for now).

Translation Function

  • Endpoint: api.addisassistant.com/api/v1/translate
  • Method: POST
  • Parameters:
    • text: The text to be translated.
    • source_language: The language of the input text (e.g., "am").
    • target_language: The language to translate the text into (e.g., "en").

Resources

This skill includes scripts/ for direct execution and references/ for API details.

scripts/

  • stt.py: Python script for Speech-to-Text.
  • translate.py: Python script for text Translation.

references/

  • api_spec.md: Detailed API specifications and curl examples.
安全使用建议
This skill appears to do what it claims (Amharic STT and translations) but there are a few things to check before installing or running it: - Verify the service/domain: api.addisassistant.com has no listed homepage in the package metadata. Confirm the API provider is legitimate and trustworthy before sending audio or text and before giving them an API key. - Provide the API key carefully: the scripts expect the x-api-key as a command-line argument, which can be visible in process lists on your system. Prefer passing secrets via a secure mechanism (stdin, environment variable, or a secrets manager) and avoid typing keys directly on shared machines. - Required binary not declared: the scripts call the curl binary but the skill metadata does not list curl as required. Ensure curl is installed, or review the scripts and consider using a vetted implementation (e.g., Python requests) that clearly documents dependencies. - Confirm TLS/URL: the examples use api.addisassistant.com without an explicit scheme; ensure the real requests use HTTPS (https://api.addisassistant.com) so data is encrypted in transit. - Audit the code before running: the included scripts are short and readable, but you should review them yourself to ensure they match the shipped content and that no modifications exfiltrate data elsewhere. Given the unknown origin and the metadata mismatches, do not hand over sensitive or high-privilege API keys until you verify the service and fix the dependency/credential handling. If you want, I can list concrete changes to make the skill safer (declare curl as required, accept API key via env or stdin, add HTTPS to endpoints, or replace curl with requests).
功能分析
Type: OpenClaw Skill Name: addis-assistant-stt Version: 1.0.0 The skill is designed for Speech-to-Text and text translation using the Addis Assistant API. The `SKILL.md` provides clear instructions without any prompt injection attempts. The Python scripts (`stt.py`, `translate.py`) use `subprocess.run` to execute `curl` commands, sending an API key and user-provided data (audio file path or text) to `api.addisassistant.com`. This behavior is directly aligned with the stated purpose of interacting with an external API and does not show evidence of intentional malicious activity such as data exfiltration beyond the API interaction, persistence, or unauthorized command execution. The use of `curl` with arguments passed as a list mitigates common shell injection risks.
能力评估
Purpose & Capability
The SKILL.md, api_spec, and the two included Python scripts all implement Speech-to-Text and translation against api.addisassistant.com, which is coherent with the skill name and description. However the registry metadata does not declare the primary credential or any required binaries even though the scripts require an API key and call the curl binary.
Instruction Scope
Runtime instructions and scripts are narrowly focused on calling the Addis Assistant endpoints. They only reference the provided audio file path or text and the x-api-key; they do not instruct the agent to read unrelated files, environment configuration, or transmit data to third-party endpoints beyond api.addisassistant.com.
Install Mechanism
No install spec is provided (instruction-only). The included code uses system curl via subprocess; nothing is downloaded or extracted by an installer. This is low install risk, but the presence of runnable scripts means users will execute code from an unknown source.
Credentials
SKILL.md and scripts require an 'x-api-key' argument, but the skill metadata does not declare any required environment variables or a primary credential. Also the scripts rely on the 'curl' binary but the required-binaries list is empty. These mismatches mean the skill's declared requirements are incomplete and could cause confusion or insecure handling of credentials.
Persistence & Privilege
The skill is not marked always:true and does not request elevated or persistent system privileges. It does spawn subprocesses (curl) to perform API calls, which is expected for this purpose and is done without shell interpolation (subprocess list usage), reducing shell-injection risk.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install addis-assistant-stt
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /addis-assistant-stt 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of addis-assistant-stt skill. - Provides Speech-to-Text (STT) for Amharic audio using Addis Assistant API. - Supports text translation between languages (e.g., Amharic to English). - Requires an `x-api-key` for authentication in all requests. - Includes Python scripts for both STT and Translation functions. - Documentation and API usage examples available in `references/`.
元数据
Slug addis-assistant-stt
版本 1.0.0
许可证
累计安装 3
当前安装数 3
历史版本数 1
常见问题

Addis Assistant 是什么?

Provides Speech-to-Text (STT) and text Translation using the Addis Assistant API (api.addisassistant.com). Use when the user needs to convert an audio file to text (specifically Amharic), or translate text between languages (e.g., Amharic to English). Requires 'x-api-key'. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2163 次。

如何安装 Addis Assistant?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install addis-assistant-stt」即可一键安装,无需额外配置。

Addis Assistant 是免费的吗?

是的,Addis Assistant 完全免费(开源免费),可自由下载、安装和使用。

Addis Assistant 支持哪些平台?

Addis Assistant 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Addis Assistant?

由 dagmawibabi(@dagmawibabi)开发并维护,当前版本 v1.0.0。

💬 留言讨论