Telegram CTA Button

Enhance Telegram replies with context-aware dynamic CTA buttons (Smart Launcher UI). Use when replying to users on Telegram to provide relevant, time-sensitive, and task-oriented options for better interaction.

Security Scan

This is an instruction-only skill that is internally consistent with its stated purpose of adding contextual CTA buttons to Telegram replies and does not request unrelated privileges or secrets.

Purpose & Capability

The name/description match the instructions: the SKILL.md only describes composing time- and context-aware Telegram reply buttons. It does implicitly assume the agent has a messaging tool that can send Telegram messages/buttons (and therefore that the platform provides the Telegram integration and bot credentials), but the skill itself does not request unrelated binaries, env vars, or access.

Instruction Scope

Instructions are scoped to selecting button presets by time-of-day and context and show how to call the 'message' tool with a buttons parameter. They do not instruct the agent to read unrelated files, environment variables, or send data to external endpoints other than using the messaging action described.

Install Mechanism

No install spec and no code files — instruction-only — so nothing is written to disk or downloaded. This minimizes install-time risk.

Credentials

The skill declares no required env vars or credentials (reasonable for an instruction-only template). In practice it relies on the agent/platform having Telegram messaging capability and bot credentials; those are not requested here but are expected to be provided by the host environment.

Persistence & Privilege

always is false, the skill doesn't request persistent presence or modify other skills or system-wide settings. It does not elevate privileges.

Assessment

This skill appears coherent and low-risk: it only suggests what buttons to show and how to format them. Before installing, confirm that your agent platform already provides the Telegram 'message' tool and bot credentials (the skill assumes those exist). Also review how callback_data values are handled by your system so sensitive information is not placed into button payloads, and test the skill in a controlled chat to ensure buttons behave as you expect.

Telegram Smart Launcher (Smart Launcher UI)

This skill enables the agent to provide an interactive and efficient user experience on Telegram by appending context-aware CTA (Call to Action) buttons to replies.

Usage Guidelines

When responding to a user on Telegram, always consider if providing quick-action buttons would improve efficiency.

Button Selection Logic

1. Time of Day Awareness:

   • Morning (07:00 - 10:00): Focus on daily briefings, commute status, and agenda checks.
   • Work Hours (10:00 - 16:00): Focus on task progress, deep research, and project-specific actions.
   • Wrap-up (16:00 - 18:00): Focus on daily recaps, route home status, and tomorrow's preparation.
   • Night (20:00 - 23:00): Focus on reflection, mood checks, and planning for the next day.

2. Context Awareness:

   • If the user is working on administrative or planning tasks, offer buttons for document drafting or data lookup.
   • If the user is working on creative or design tasks, offer buttons for tool links or asset management.
   • If a task just finished, offer "Next Steps" or "Recap" buttons.

3. The "Free Text" Fallback:

   • Always include an option for free text input (e.g., "⌨️ Manual Input") to ensure the user feels in control.

Implementation Pattern

Use the message tool with the buttons parameter. The buttons array is an array of arrays (rows) of button objects [{text, callback_data}].

Example (Wrap-up Phase)

message({
  action: "send",
  target: "USER_ID",
  message: "I've prepared the daily report for you.",
  buttons: [
    [
      { text: "📝 Daily Recap", callback_data: "/update" },
      { text: "🏠 Route Home", callback_data: "Check route home" }
    ],
    [
      { text: "⏭️ Tomorrow's Agenda", callback_data: "What is the agenda for tomorrow?" },
      { text: "⌨️ Manual Input", callback_data: "keyboard_manual" }
    ]
  ]
})

References

• See references/time_logic.md for detailed time-based button presets.