agentleFS
deathbyknowledgedeathbyknowledge/gsv/skills/calendar/SKILL.md

calendar

Skill134 starsChanged 4 months agoMITView on GitHub

Add events to the owner's calendar, invite people, and read their calendar from a private link. Use for "add this to my calendar", "what's on Thursday", "am I free", or an event file someone sent.

33 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use reminders, email and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • MicrosoftSkill

    reminders

    Use when an employee asks something like \"Is there anything else I should know about my benefits or time off before the end of the year\"

    Also in 4 projects that use this

  • OpenAISkill

    email

    Email sending integration guidance — Resend (native Vercel Marketplace) with React Email templates. Covers API setup, transactional emails, domain verification, and template patterns. Use when sending emails from a Vercel-deployed application.

    Also in 6 projects that use this

  • toolittlecakesSkill

    telegram

    Read Telegram messages and chats. Use when the user wants to search Telegram chats, list dialogs, or get messages from a chat. Requires authentication on first use.

    Also in 3 projects that use this

  • QuixiAISkill

    trello

    List Trello boards, lists, and cards and create or update cards with explicit approval

    Also in 3 projects that use this

  • AnthropicSkill

    access

    Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

    Also in 3 projects that use this

  • GoogleSkill

    translate

    Translates a common phrase into one or more languages.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 1 is distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 25 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run cal and mail through Shell on target gsv.

    line 8
  2. Very specific:

    Use their address from context.d/10-personal.md, never Ship's own, and ask which one if they have several.

    line 16
  3. Very specific:

    Add one --attendee per guest, including the owner when they attend.

    line 30
  4. Very specific:

    Never pipe mail send through tail, head or another command: that hides its exit status and error.

    line 36
  5. Distinctive:

    Ask the owner for their calendar's private link, which shows Ship every event:

    line 43

“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Calendar

Run cal and mail through Shell on target gsv; man cal has the syntax. Ship can't edit the owner's calendar directly. It writes an event file and emails it as an invitation, which the owner's calendar adds; and it reads the owner's calendar through a private link they share.

Add Something to the Owner's Calendar

An invitation goes only to the event's guests, so the owner must be a guest. Use their address from context.d/10-personal.md, never Ship's own, and ask which one if they have several.

cal add --title "Flight to Palma" --start "2026-11-24 07:45" --end "2026-11-24 10:10" --location "Schiphol" --attendee owner@example.com --out ~/calendar/palma-flight.ics
mail send --invite ~/calendar/palma-flight.ics --subject "Flight to Palma" --message "Your flight, for your calendar."

Times read in the owner's time zone unless --timezone names another. Keep the file: to move or call off the event, cal update or cal cancel it and send it again, and the calendar replaces the event.

Invite Other People

Add one --attendee per guest, including the owner when they attend. Their answers come back to Ship's inbox as mail; report who accepted or declined. Sending asks the owner for approval, which names everyone invited.

Check It Went

Never pipe mail send through tail, head or another command: that hides its exit status and error. Read its output, then confirm with mail status <delivery-id>. Say an invite was sent only when the status is queued or accepted; on an error, fix it and say what happened.

Read the Owner's Calendar

Ask the owner for their calendar's private link, which shows Ship every event:

  • Google Calendar: Settings → the calendar under "Settings for my calendars" → Integrate calendar → Secret address in iCal format.
  • Outlook: Settings → Calendar → Shared calendars → Publish a calendar, with "can view all details", then copy the ICS link. Work accounts may have publishing turned off.
  • iCloud: share the calendar as a Public Calendar and copy the link. Anyone with that link can see it, so say so.

The link is a secret: anyone holding it can read the calendar. Keep it in a private file under your home, such as ~/calendar/links, never in the wiki, standing context, a message or a reply. Write a webcal:// link as https://.

Fetch it fresh before answering, since the calendar changes, then show the days asked about:

net fetch "https://calendar.example.com/private-link.ics" -o ~/calendar/owner.ics
cal show ~/calendar/owner.ics --from 2026-11-19
cal show ~/calendar/owner.ics --from 2026-11-16 --until 2026-11-22

A date stands for its whole day, and --from alone shows one day. Repeating events appear on each of their dates. Google can take a few hours to show a new event in the link; mention it when something seems missing.

Event Files Someone Sends

cal show PATH reads any calendar file, such as one sent in chat or attached to mail: its times, guests and a repeating event's next dates. Only the event's organizer can change it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.