← Back to Skills Marketplace
biao29

OpenTIL

by biao29 · GitHub ↗ · v1.11.0
cross-platform ⚠ suspicious
970
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install til
Description
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.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install til
  3. After installation, invoke the skill by name or use /til
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug til
Version 1.11.0
License
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 970 downloads so far.

How do I install OpenTIL?

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

Is OpenTIL free?

Yes, OpenTIL is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OpenTIL support?

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

Who created OpenTIL?

It is built and maintained by biao29 (@biao29); the current version is v1.11.0.

💬 Comments