← 返回 Skills 市场
biao29

OpenTIL

作者 biao29 · GitHub ↗ · v1.11.0
cross-platform ⚠ suspicious
970
总下载
0
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install til
功能描述
Capture and manage TIL (Today I Learned) entries on OpenTIL. Use /til <content> to capture, /til to extract insights from conversation, or /til list|publish|edit|search|delete|status|sync|tags|categories|batch to manage entries -- all without leaving the CLI.
安全使用建议
What to check before installing: - Metadata mismatch: the registry entry claims no required env vars but SKILL.md uses a primaryEnv (OPENTIL_TOKEN). Expect to provide an OPENTIL_TOKEN environment variable or allow the skill to create/modify ~/.til/credentials. - Token scope: you will be asked to create a token with read:entries, write:entries, and delete:entries. Only grant scopes you are comfortable with (delete scope allows permanent deletes). - Local file writes: the skill will create and modify ~/.til/credentials and ~/.til/drafts/ and will migrate an old plaintext token into YAML automatically. Back up any existing ~/.til files if you care about them. - OAuth flow: the auth command opens your browser (open/xdg-open) and runs a polling loop to obtain a token — this requires the agent to run shell commands that interact with the system browser. - Proactive suggestions: the auto-detection doc instructs the agent to append TIL suggestions to normal responses. If you don’t want unsolicited suggestions appended to agent outputs, avoid enabling that feature or confirm how/when it runs. If you proceed: create a dedicated token with the minimum necessary scopes, inspect ~/.til after first run, and consider setting OPENTIL_TOKEN in your environment rather than relying on profile migration if you want explicit control. If you need higher assurance, ask the publisher to fix the registry metadata to declare OPENTIL_TOKEN so required permissions are transparent.
功能分析
Type: OpenClaw Skill Name: til Version: 1.11.0 The OpenClaw AgentSkills skill bundle for OpenTIL is classified as benign. It performs expected operations for a 'Today I Learned' management tool, including extensive API calls to `https://opentil.ai`, reading/writing sensitive API tokens to `~/.til/credentials`, and managing local drafts in `~/.til/drafts/`. While these capabilities are high-risk, the skill explicitly implements strong security measures like `chmod 600` for the credentials file and guides users on secure token management. A prompt injection instruction ('DO NOT read reference files unless specified below') is present in `SKILL.md`, but its intent is to control the agent's internal context rather than to induce malicious behavior, making it a benign control mechanism.
能力评估
Purpose & Capability
The skill's described purpose (capture and manage TILs on OpenTIL) matches the instructions and API calls in SKILL.md: it uses OpenTIL endpoints, supports publish/edit/delete/sync, and stores local drafts. However, registry metadata lists no required env vars while SKILL.md declares a primaryEnv (OPENTIL_TOKEN) and explicitly requires a Personal Access Token; this metadata mismatch is inconsistent and should be corrected.
Instruction Scope
Runtime instructions are focused on the stated purpose and do not ask the agent to read arbitrary system files. The skill will: read $OPENTIL_TOKEN, read/write ~/.til/credentials, create and list ~/.til/drafts/, open the system browser (open/xdg-open) for device auth, and poll the OAuth device endpoint via shell. It also includes an 'auto-detection' feature that instructs the agent to proactively append TIL suggestions to normal responses — this is functional scope creep (behavioral, not credential access) that you should be aware of.
Install Mechanism
No install spec or code files; this is instruction-only. Nothing is downloaded or written by an installer. Risk from install mechanism is low.
Credentials
The skill legitimately needs an OpenTIL token (read:entries, write:entries, delete:entries) to perform management operations. It will accept a token from $OPENTIL_TOKEN or from ~/.til/credentials and will migrate an old plaintext token into a YAML profile automatically. That write/migration behavior is expected but should be noted because it modifies files under your home directory. No other unrelated credentials or environment variables are requested.
Persistence & Privilege
The skill is not 'always' enabled and does not request elevated system privileges. It will create/read/write files under ~/.til/ (credentials and drafts) and may delete local draft files after a successful sync. Autonomous invocation is allowed by default (normal for skills) and the auto-detection feature will cause the agent to append TIL suggestions to responses when enabled — consider whether you want that proactive behavior.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install til
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /til 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.11.0
Version 1.11.0 - Added support for multiple named OpenTIL profiles within `~/.til/credentials` (YAML format). - Introduced profile management subcommands: `/til auth switch`, `/til auth list`, `/til auth remove`, `/til auth rename`. - Automatic migration of pre-existing plain-text credentials to new YAML profile format. - When multiple profiles exist, result messages now display active account info for clarity. - Updated token resolution order and improved error messages/guidance for token issues.
v1.10.0
Version 1.10.0 - Added support for the new summary field on TIL entries, including summary generation guidelines and API parameter (`summary`). - Enhanced execution flow and error handling for 401 Unauthorized responses: added inline re-authentication using the device flow when appropriate. - Updated instructions for `/til <content>` to always generate an entry summary. - Improved documentation on API usage, now including the summary field in sample payloads and key parameter tables. - Clarified token management behavior and user guidance when OPENTIL_TOKEN is invalid or missing.
v1.7.0
til 1.7.0 - Updated documentation to clarify setup steps, subcommand routing, and execution flow. - Expanded usage details for each `/til` subcommand, including new examples and tables. - Added comprehensive API quick reference with parameter, endpoint, and error-handling notes. - Improved guidance for first-run experience and local draft fallback. - Refined instructions for generating, editing, and confirming TIL entries directly from user input or conversation context.
元数据
Slug til
版本 1.11.0
许可证
累计安装 1
当前安装数 1
历史版本数 3
常见问题

OpenTIL 是什么?

Capture and manage TIL (Today I Learned) entries on OpenTIL. Use /til <content> to capture, /til to extract insights from conversation, or /til list|publish|edit|search|delete|status|sync|tags|categories|batch to manage entries -- all without leaving the CLI. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 970 次。

如何安装 OpenTIL?

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

OpenTIL 是免费的吗?

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

OpenTIL 支持哪些平台?

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

谁开发了 OpenTIL?

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

💬 留言讨论