agent-skills
Agent-agnostic skills, including plain-text meetings to ICS calendar generation.
Open source Open in the app JSON README (API)
About
Agent-agnostic skills, including plain-text meetings to ICS calendar generation.
Details
- Kind
- Plugins
- Topic
- Productivity
- Publisher
- mlowery
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Last push
- 2026-05-05T02:19:17Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
mlowery/skill-issue
README
# Agent Skills
Public, agent-agnostic skills packaged as folders with a `SKILL.md` file and optional supporting scripts.
## About The Name
Some problems really are skill issues. This repo collects the reusable kind: small, inspectable skill packages that agents can load when one-off prompting is not enough.
## Skills
- [`plaintext-meetings-to-ics`](skills/plaintext-meetings-to-ics/SKILL.md): interpret arbitrary plain-text meeting schedules, review inferred events with the user, and generate an `.ics` calendar file from confirmed structured events.
- [`leetcode-go-starter`](skills/leetcode-go-starter/SKILL.md): scaffold a minimal Go workspace for a LeetCode problem, including starter code, table-driven tests from current examples, a Makefile test target, and a brief problem README.
## Workflow Model
Skills in this repo are agent-agnostic instruction folders. The first skill uses this flow:
1. The agent interprets arbitrary source text and resolves candidate calendar events.
2. The agent shows a numbered review list before writing files.
3. The user replies with event numbers, an optional common title prefix, and output mode:
```text
events: 1,2,4; prefix: Team - ; output: combined
```
```text
events: 1,2,4; prefix: none; output: per-event
```
4. The agent writes confirmed events to JSON and runs the bundled generator.
5. The generator writes either one combined `.ics` file or one `.ics` file per selected event.
## Install
### Codex
Copy or symlink all skill folders into your Codex skills directory:
```bash
mkdir -p ~/.codex/skills
cp -R skills/* ~/.codex/skills/
```
To install one skill instead, copy that folder only:
```bash
cp -R skills/leetcode-go-starter ~/.codex/skills/
```
Restart Codex, then ask for a task that matches one of the skills.
### Claude Code
Claude Code discovers custom skills from personal and project skill folders. Install as a personal skill:
```bash
mkdir -p ~/.claude/skills
cp -R skills/* ~/.claude/skills/
```
Or install all skills as project skills:
```bash
mkdir -p .claude/skills
cp -R skills/* .claude/skills/
```
Restart Claude Code, then ask for a task that matches one of the skills. Claude's docs describe this `SKILL.md` folder format and the personal/project paths: <https://docs.claude.com/en/docs/claude-code/skills>.
### Gemini CLI
This repository is also a Gemini CLI extension. Install from a local checkout while developing:
```bash
gemini extensions link /path/to/agent-skills
```
Or install from a published Git repository:
```bash
gemini extensions install https://github.com/YOUR_ORG/agent-skills
```
Restart Gemini CLI after installing or updating. Gemini's extension docs describe the `gemini-extension.json` manifest and `gemini extensions` commands: <https://google-gemini.github.io/gemini-cli/docs/extensions/>.
## Example Prompts
```text
Turn this plain-text practice schedule into an ICS file for macOS Calendar.
```
```text
Use the LeetCode Go starter skill to scaffold a Go workspace for https://leetcode.com/problems/merge-sorted-array/
```
## Direct Script Use
The first skill includes a standalone ICS generator. Agents should interpret arbitrary text themselves, ask the user to confirm a review table, then write confirmed events as JSON:
```json
{
"calendar_name": "Imported Schedule",
"timezone": "America/Denver",
"title_prefix": "Team - ",
"events": [
{
"title": "Weights and Agility",
"start": "2026-05-05T17:00:00",
"end": "2026-05-05T18:15:00",
"source": "Tue- Weights and Agility 5-6:15 PM"
}
]
}
```
Then run:
```bash
python3 skills/plaintext-meetings-to-ics/scripts/events_to_ics.py review confirmed-events.json
python3 skills/plaintext-meetings-to-ics/scripts/events_to_ics.py create confirmed-events.json --output schedule.ics
python3 skills/plaintext-meetings-to-ics/scripts/events_to_ics.py create confirmed-events.json --per-event-output-dir schedule-events
```