til

What This Skill Does

The til skill for OpenClaw acts as an integrated bridge between your CLI workflow and the OpenTIL platform. It allows users to capture, manage, and publish "Today I Learned" (TIL) content without ever leaving their terminal. Whether you are documenting a quick coding epiphany, tracking research notes, or compiling insights from ongoing conversations, this skill handles the heavy lifting by managing drafts, syncing to the cloud, and providing AI-assisted editing tools. It supports multi-profile management, enabling users to maintain separate identities for personal and professional knowledge bases.

Installation

To integrate the TIL capability into your OpenClaw agent, run the following command in your terminal:

clawhub install openclaw/skills/skills/biao29/til

After installation, authenticate your account using /til auth or by setting the OPENTIL_TOKEN environment variable. The skill will automatically handle configuration files in ~/.til/ to store your profiles and credentials.

Use Cases

• Rapid Documentation: Instantly capture snippets as you work, ensuring you never lose track of a hard-earned lesson.
• Content Curation: Extract key insights directly from your terminal conversation logs and turn them into structured TIL posts.
• Professional/Personal Separation: Use the profile switching feature to keep your work-related technical documentation separate from your personal hobbyist notes.
• Offline Drafting: Write entries on the go or while offline; these will be safely cached in your local ~/.til/drafts folder until you choose to sync them to the live site.

Example Prompts

1. "/til I learned that PostgreSQL JSONB indexes can significantly speed up deep key lookups in nested structures."
2. "/til list drafts"
3. "/til extract the summary from our recent discussion about Kubernetes networking as a new TIL entry."

Tips & Limitations

• Prioritize Profiles: If you have multiple accounts, always check your active profile via /til auth list before publishing to ensure your post hits the correct destination.
• AI Editing: Use /til edit <id> for quick, context-aware improvements to your rough draft content. The AI will refine your writing while keeping the core message intact.
• Environment Variables: For automated CI/CD pipelines or server environments, prioritize setting the OPENTIL_TOKEN variable over local config files for seamless, non-interactive authentication.
• Limitations: The skill requires an active internet connection for syncing or publishing. Ensure your local ~/.til/ directory has proper write permissions to avoid errors during drafting.