email-cli-tool 0.2.1__tar.gz → 0.3.1__tar.gz

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/.github/workflows/publish.yml

@@ -3,6 +3,7 @@ name: Publish to PyPI
 on:
   release:
     types: [published]
+  workflow_dispatch:
 
 jobs:
   publish:

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: email-cli-tool
-Version: 0.2.1
+Version: 0.3.1
 Summary: A simple CLI tool for sending emails with plain text, HTML, and file attachments
 Project-URL: Homepage, https://github.com/ClaymanTwinkle/email-cli-tool
 Project-URL: Repository, https://github.com/ClaymanTwinkle/email-cli-tool
@@ -38,6 +38,7 @@ Description-Content-Type: text/markdown
 - Direct SMTP connection (SSL / STARTTLS)
 - Interactive configuration wizard
 - Read body content from stdin
+- Wait for the next incoming email (IMAP) and download its attachments
 
 ## Installation
 
@@ -108,6 +109,18 @@ echo "Content" | emailcli send \
   --to user@example.com --subject "Piped" --body -
 ```
 
+### 3. Wait for Incoming Email
+
+```bash
+# Block until the next email arrives, print it, then exit
+emailcli watch
+
+# Wait up to 5 minutes and save attachments
+emailcli watch --timeout 300 --save-attachments ./downloads
+```
+
+Requires IMAP settings — `emailcli init` asks for them, or add an `imap` section to the config (see below).
+
 ## Command Reference
 
 ### `emailcli send`
@@ -124,6 +137,17 @@ echo "Content" | emailcli send \
 
 > At least one of `--body`, `--html`, or `--html-file` is required.
 
+### `emailcli watch`
+
+Wait for the next incoming email (via IMAP polling), print headers and body to stdout, then exit. Only emails arriving **after** the command starts are matched; the received email is marked as read.
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--timeout` | `0` (wait forever) | Max seconds to wait; exits with code `2` on timeout |
+| `--poll-interval` | `10` | Seconds between mailbox checks |
+| `--save-attachments` | | Directory to save attachments into |
+| `--mailbox` | `INBOX` | Mailbox to watch |
+
 ### `emailcli init`
 
 Interactively create the configuration file at `~/.emailcli/config.yaml`.
@@ -134,7 +158,7 @@ Display current configuration (password is masked).
 
 ### `emailcli skill install`
 
-Install the `send-email` agent skill so Claude Code or Codex can send mail for you.
+Install the `send-email` and `wait-email` agent skills so Claude Code or Codex can send and receive mail for you.
 
 ```bash
 # Install for both Claude Code and Codex (default)
@@ -145,7 +169,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-Writes `SKILL.md` to `~/.claude/skills/send-email/` and/or `~/.codex/skills/send-email/`.
+Writes each skill's `SKILL.md` under `~/.claude/skills/` and/or `~/.codex/skills/`.
 
 ## Configuration
 
@@ -159,6 +183,13 @@ smtp:
   username: yourname@gmail.com
   password: your-app-password
   encryption: ssl  # ssl | starttls | none
+
+# Optional, only needed for `emailcli watch`
+imap:
+  host: imap.gmail.com
+  port: 993        # default: 993
+  encryption: ssl  # default: ssl
+  # username/password default to the smtp values
 ```
 
 ## Development

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/README.md

@@ -12,6 +12,7 @@
 - Direct SMTP connection (SSL / STARTTLS)
 - Interactive configuration wizard
 - Read body content from stdin
+- Wait for the next incoming email (IMAP) and download its attachments
 
 ## Installation
 
@@ -82,6 +83,18 @@ echo "Content" | emailcli send \
   --to user@example.com --subject "Piped" --body -
 ```
 
+### 3. Wait for Incoming Email
+
+```bash
+# Block until the next email arrives, print it, then exit
+emailcli watch
+
+# Wait up to 5 minutes and save attachments
+emailcli watch --timeout 300 --save-attachments ./downloads
+```
+
+Requires IMAP settings — `emailcli init` asks for them, or add an `imap` section to the config (see below).
+
 ## Command Reference
 
 ### `emailcli send`
@@ -98,6 +111,17 @@ echo "Content" | emailcli send \
 
 > At least one of `--body`, `--html`, or `--html-file` is required.
 
+### `emailcli watch`
+
+Wait for the next incoming email (via IMAP polling), print headers and body to stdout, then exit. Only emails arriving **after** the command starts are matched; the received email is marked as read.
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--timeout` | `0` (wait forever) | Max seconds to wait; exits with code `2` on timeout |
+| `--poll-interval` | `10` | Seconds between mailbox checks |
+| `--save-attachments` | | Directory to save attachments into |
+| `--mailbox` | `INBOX` | Mailbox to watch |
+
 ### `emailcli init`
 
 Interactively create the configuration file at `~/.emailcli/config.yaml`.
@@ -108,7 +132,7 @@ Display current configuration (password is masked).
 
 ### `emailcli skill install`
 
-Install the `send-email` agent skill so Claude Code or Codex can send mail for you.
+Install the `send-email` and `wait-email` agent skills so Claude Code or Codex can send and receive mail for you.
 
 ```bash
 # Install for both Claude Code and Codex (default)
@@ -119,7 +143,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-Writes `SKILL.md` to `~/.claude/skills/send-email/` and/or `~/.codex/skills/send-email/`.
+Writes each skill's `SKILL.md` under `~/.claude/skills/` and/or `~/.codex/skills/`.
 
 ## Configuration
 
@@ -133,6 +157,13 @@ smtp:
   username: yourname@gmail.com
   password: your-app-password
   encryption: ssl  # ssl | starttls | none
+
+# Optional, only needed for `emailcli watch`
+imap:
+  host: imap.gmail.com
+  port: 993        # default: 993
+  encryption: ssl  # default: ssl
+  # username/password default to the smtp values
 ```
 
 ## Development

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/README_CN.md

@@ -12,6 +12,7 @@
 - SMTP 直连（支持 SSL / STARTTLS）
 - 交互式配置向导
 - 从 stdin 读取正文内容
+- 等待下一封新邮件（IMAP）并下载附件
 
 ## 安装
 
@@ -82,6 +83,18 @@ echo "邮件内容" | emailcli send \
   --to user@example.com --subject "Piped" --body -
 ```
 
+### 3. 等待新邮件
+
+```bash
+# 阻塞等待下一封新邮件，打印内容后退出
+emailcli watch
+
+# 最多等 5 分钟，并保存附件
+emailcli watch --timeout 300 --save-attachments ./downloads
+```
+
+需要 IMAP 配置 —— `emailcli init` 会询问，也可以手动在配置文件中加 `imap` 段（见下文）。
+
 ## 命令参考
 
 ### `emailcli send`
@@ -98,6 +111,17 @@ echo "邮件内容" | emailcli send \
 
 > `--body` 和 `--html` / `--html-file` 至少提供一个。
 
+### `emailcli watch`
+
+通过 IMAP 轮询等待下一封新邮件，把邮件头和正文打印到 stdout 后退出。只匹配命令启动**之后**到达的邮件；收到的邮件会被标记为已读。
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `--timeout` | `0`（一直等） | 最长等待秒数，超时退出码为 `2` |
+| `--poll-interval` | `10` | 轮询间隔（秒） |
+| `--save-attachments` | | 附件保存目录 |
+| `--mailbox` | `INBOX` | 监听的邮箱文件夹 |
+
 ### `emailcli init`
 
 交互式创建配置文件 `~/.emailcli/config.yaml`。
@@ -108,7 +132,7 @@ echo "邮件内容" | emailcli send \
 
 ### `emailcli skill install`
 
-安装 `send-email` 技能，让 Claude Code 或 Codex 可以直接帮你发邮件。
+安装 `send-email` 和 `wait-email` 技能，让 Claude Code 或 Codex 可以直接帮你收发邮件。
 
 ```bash
 # 默认同时安装到 Claude Code 和 Codex
@@ -119,7 +143,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-会把 `SKILL.md` 写入 `~/.claude/skills/send-email/` 和/或 `~/.codex/skills/send-email/`。
+会把各技能的 `SKILL.md` 写入 `~/.claude/skills/` 和/或 `~/.codex/skills/` 下的同名目录。
 
 ## 配置文件
 
@@ -133,6 +157,13 @@ smtp:
   username: yourname@163.com
   password: your-auth-code
   encryption: ssl  # ssl | starttls | none
+
+# 可选，仅 `emailcli watch` 需要
+imap:
+  host: imap.163.com
+  port: 993        # 默认 993
+  encryption: ssl  # 默认 ssl
+  # username/password 默认复用 smtp 的值
 ```
 
 ## 开发

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "email-cli-tool"
-version = "0.2.1"
+version = "0.3.1"
 description = "A simple CLI tool for sending emails with plain text, HTML, and file attachments"
 readme = "README.md"
 license = "MIT"

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/src/emailcli/cli.py

@@ -6,6 +6,7 @@ import click
 from emailcli.config import load_config
 from emailcli.exceptions import EmailCliError
 from emailcli.message import build_message
+from emailcli.receiver import ImapReceiver, extract_body, save_attachments
 from emailcli.sender import SmtpSender
 from emailcli import skill_install
 
@@ -74,6 +75,71 @@ def send(to_addrs, subject, body, html_content, html_file_path, attachments, fro
         raise SystemExit(1)
 
 
+@cli.command()
+@click.option("--timeout", default=0.0, type=float, help="Max seconds to wait for a new email (0 = wait forever).")
+@click.option("--poll-interval", default=10.0, type=float, show_default=True, help="Seconds between mailbox checks.")
+@click.option("--save-attachments", "attachments_dir", default=None, type=click.Path(file_okay=False), help="Directory to save attachments into.")
+@click.option("--mailbox", default="INBOX", show_default=True, help="Mailbox to watch.")
+@click.option("--config-dir", default=None, type=click.Path(), hidden=True, help="Config directory (for testing).")
+def watch(timeout, poll_interval, attachments_dir, mailbox, config_dir):
+    """Wait for the next incoming email, print it, then exit.
+
+    Only emails arriving after the command starts are matched. Exits with
+    code 0 when an email was received, 2 on timeout.
+    """
+    try:
+        cfg_dir = Path(config_dir) if config_dir else None
+        config = load_config(cfg_dir)
+
+        if config.imap is None:
+            raise EmailCliError(
+                "No IMAP settings in config. Re-run 'emailcli init' "
+                "or add an 'imap' section to config.yaml."
+            )
+
+        receiver = ImapReceiver(
+            host=config.imap.host,
+            port=config.imap.port,
+            username=config.imap.username,
+            password=config.imap.password,
+            encryption=config.imap.encryption,
+        )
+
+        click.echo(f"Waiting for new email in {mailbox}... (Ctrl-C to stop)", err=True)
+        msg = receiver.wait_for_message(
+            mailbox=mailbox, timeout=timeout, poll_interval=poll_interval
+        )
+        if msg is None:
+            click.echo(f"Timed out after {timeout:g}s with no new email.", err=True)
+            raise SystemExit(2)
+
+        click.echo(f"From:    {msg.get('From', '')}")
+        click.echo(f"To:      {msg.get('To', '')}")
+        click.echo(f"Subject: {msg.get('Subject', '')}")
+        click.echo(f"Date:    {msg.get('Date', '')}")
+        click.echo("")
+
+        body, kind = extract_body(msg)
+        if body:
+            if kind == "html":
+                click.echo("(HTML body)", err=True)
+            click.echo(body)
+        else:
+            click.echo("(no text body)", err=True)
+
+        if attachments_dir:
+            saved = save_attachments(msg, Path(attachments_dir))
+            if saved:
+                for path in saved:
+                    click.echo(f"Saved attachment: {path}", err=True)
+            else:
+                click.echo("No attachments.", err=True)
+    except EmailCliError as e:
+        click.echo(f"Error: {e}", err=True)
+        raise SystemExit(1)
+
+
+
 @cli.command()
 @click.option("--config-dir", default=None, type=click.Path(), hidden=True, help="Config directory (for testing).")
 def init(config_dir):
@@ -101,6 +167,25 @@ def init(config_dir):
         "Encryption (starttls/ssl/none)", default="ssl"
     )
 
+    imap_section = None
+    if click.confirm("\nConfigure IMAP (needed for 'emailcli watch')?", default=False):
+        imap_host = click.prompt("IMAP host")
+        imap_port = click.prompt("IMAP port", type=int, default=993)
+        imap_username = click.prompt("IMAP username", default=smtp_username)
+        imap_password = click.prompt(
+            "IMAP password (empty = same as SMTP)",
+            hide_input=True, default="", show_default=False,
+        )
+        imap_encryption = click.prompt("IMAP encryption (ssl/starttls/none)", default="ssl")
+        imap_section = {
+            "host": imap_host,
+            "port": imap_port,
+            "username": imap_username,
+            "encryption": imap_encryption,
+        }
+        if imap_password:
+            imap_section["password"] = imap_password
+
     config_data = {
         "from": from_addr,
         "smtp": {
@@ -111,6 +196,8 @@ def init(config_dir):
             "encryption": smtp_encryption,
         },
     }
+    if imap_section:
+        config_data["imap"] = imap_section
 
     cfg_dir.mkdir(parents=True, exist_ok=True)
     with open(config_file, "w") as f:
@@ -139,6 +226,12 @@ def show(config_dir):
         click.echo(f"Username:   {cfg.smtp_username}")
         click.echo(f"Password:   ***")
         click.echo(f"Encryption: {cfg.smtp_encryption}")
+        if cfg.imap:
+            click.echo("")
+            click.echo(f"IMAP Host:  {cfg.imap.host}")
+            click.echo(f"IMAP Port:  {cfg.imap.port}")
+            click.echo(f"IMAP User:  {cfg.imap.username}")
+            click.echo(f"IMAP Encryption: {cfg.imap.encryption}")
     except EmailCliError as e:
         click.echo(f"Error: {e}", err=True)
         raise SystemExit(1)
@@ -159,7 +252,7 @@ def skill_group():
 )
 @click.option("--home", default=None, type=click.Path(), hidden=True, help="Home directory (for testing).")
 def install(target, home):
-    """Install the send-email skill into Claude Code and/or Codex."""
+    """Install the emailcli agent skills into Claude Code and/or Codex."""
     home_dir = Path(home) if home else Path.home()
     targets = ["claude", "codex"] if target == "all" else [target]
 

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/src/emailcli/config.py

@@ -6,6 +6,15 @@ import yaml
 from emailcli.exceptions import ConfigError
 
 
+@dataclass(frozen=True)
+class ImapConfig:
+    host: str
+    port: int
+    username: str
+    password: str
+    encryption: str  # "ssl" | "starttls" | "none"
+
+
 @dataclass(frozen=True)
 class ConfigData:
     from_addr: str
@@ -14,6 +23,7 @@ class ConfigData:
     smtp_username: str
     smtp_password: str
     smtp_encryption: str  # "starttls" | "ssl" | "none"
+    imap: ImapConfig | None = None
 
 
 def load_config(config_dir: Path | None = None) -> ConfigData:
@@ -43,6 +53,23 @@ def load_config(config_dir: Path | None = None) -> ConfigData:
         if field not in smtp:
             raise ConfigError(f"Missing required smtp field: '{field}'")
 
+    imap_data = data.get("imap")
+    imap = None
+    if imap_data is not None:
+        if not isinstance(imap_data, dict):
+            raise ConfigError("'imap' must be a mapping")
+        if "host" not in imap_data:
+            raise ConfigError("Missing required imap field: 'host'")
+        # Username/password default to the SMTP credentials (common case:
+        # same account, e.g. a Gmail app password works for both).
+        imap = ImapConfig(
+            host=imap_data["host"],
+            port=imap_data.get("port", 993),
+            username=imap_data.get("username", smtp["username"]),
+            password=imap_data.get("password", smtp["password"]),
+            encryption=imap_data.get("encryption", "ssl"),
+        )
+
     return ConfigData(
         from_addr=data.get("from", ""),
         smtp_host=smtp["host"],
@@ -50,4 +77,5 @@ def load_config(config_dir: Path | None = None) -> ConfigData:
         smtp_username=smtp["username"],
         smtp_password=smtp["password"],
         smtp_encryption=smtp.get("encryption", "starttls"),
+        imap=imap,
     )

{email_cli_tool-0.2.1 → email_cli_tool-0.3.1}/src/emailcli/exceptions.py

@@ -12,3 +12,7 @@ class MessageError(EmailCliError):
 
 class SendError(EmailCliError):
     """Email sending errors."""
+
+
+class ReceiveError(EmailCliError):
+    """Email receiving errors."""

email_cli_tool-0.3.1/src/emailcli/receiver.py

@@ -0,0 +1,146 @@
+import email
+import email.policy
+import imaplib
+import re
+import time
+from email.message import EmailMessage
+from pathlib import Path
+
+from emailcli.exceptions import ReceiveError
+
+_UIDNEXT_RE = re.compile(rb"UIDNEXT (\d+)")
+
+
+class ImapReceiver:
+    def __init__(
+        self,
+        host: str,
+        port: int,
+        username: str,
+        password: str,
+        encryption: str,
+    ):
+        self.host = host
+        self.port = port
+        self.username = username
+        self.password = password
+        self.encryption = encryption
+
+    def _connect(self) -> imaplib.IMAP4:
+        try:
+            if self.encryption == "ssl":
+                conn = imaplib.IMAP4_SSL(self.host, self.port)
+            else:
+                conn = imaplib.IMAP4(self.host, self.port)
+                if self.encryption == "starttls":
+                    conn.starttls()
+            conn.login(self.username, self.password)
+            return conn
+        except Exception as e:
+            raise ReceiveError(f"Failed to connect to IMAP server: {e}") from e
+
+    def wait_for_message(
+        self,
+        mailbox: str = "INBOX",
+        timeout: float = 0,
+        poll_interval: float = 10.0,
+    ) -> EmailMessage | None:
+        """Block until a message arrives after this call starts.
+
+        Polls the mailbox every poll_interval seconds and returns the first
+        message whose UID is >= the UIDNEXT recorded at start, so existing
+        unread mail is ignored. Returns None if timeout (seconds, 0 = no
+        limit) expires first.
+        """
+        conn = self._connect()
+        try:
+            typ, data = conn.status(mailbox, "(UIDNEXT)")
+            if typ != "OK":
+                raise ReceiveError(f"IMAP STATUS failed: {data}")
+            match = _UIDNEXT_RE.search(data[0])
+            if not match:
+                raise ReceiveError(f"Could not read UIDNEXT from: {data[0]!r}")
+            uidnext = int(match.group(1))
+
+            typ, data = conn.select(mailbox)
+            if typ != "OK":
+                raise ReceiveError(f"Cannot select mailbox {mailbox!r}: {data}")
+
+            deadline = time.monotonic() + timeout if timeout > 0 else None
+            while True:
+                # NOOP prompts the server to report newly arrived messages.
+                conn.noop()
+                typ, data = conn.uid("search", "UID", f"{uidnext}:*")
+                if typ != "OK":
+                    raise ReceiveError(f"IMAP SEARCH failed: {data}")
+                uids = [int(u) for u in data[0].split()] if data and data[0] else []
+                # "N:*" also matches the last existing message when its UID
+                # is below N, so keep only genuinely new UIDs.
+                new = sorted(u for u in uids if u >= uidnext)
+                if new:
+                    return self._fetch(conn, new[0])
+                if deadline is not None and time.monotonic() >= deadline:
+                    return None
+                sleep_for = poll_interval
+                if deadline is not None:
+                    sleep_for = min(sleep_for, max(0.0, deadline - time.monotonic()))
+                time.sleep(sleep_for)
+        except ReceiveError:
+            raise
+        except Exception as e:
+            raise ReceiveError(f"Failed while waiting for email: {e}") from e
+        finally:
+            try:
+                conn.logout()
+            except Exception:
+                pass
+
+    def _fetch(self, conn: imaplib.IMAP4, uid: int) -> EmailMessage:
+        typ, msg_data = conn.uid("fetch", str(uid), "(RFC822)")
+        if typ != "OK":
+            raise ReceiveError(f"IMAP FETCH failed: {msg_data}")
+        raw = None
+        for item in msg_data:
+            if isinstance(item, tuple) and len(item) >= 2 and isinstance(item[1], (bytes, bytearray)):
+                raw = item[1]
+                break
+        if raw is None:
+            raise ReceiveError(f"Unexpected FETCH response for UID {uid}")
+        return email.message_from_bytes(raw, policy=email.policy.default)
+
+
+def extract_body(msg: EmailMessage) -> tuple[str, str]:
+    """Return (content, kind) where kind is "text", "html", or ""."""
+    part = msg.get_body(preferencelist=("plain", "html"))
+    if part is None:
+        return "", ""
+    kind = "html" if part.get_content_subtype() == "html" else "text"
+    return part.get_content(), kind
+
+
+def save_attachments(msg: EmailMessage, dest: Path) -> list[Path]:
+    """Save all attachments into dest, returning the written paths.
+
+    Filenames are stripped to their basename and deduplicated with -1, -2...
+    suffixes so a crafted attachment name cannot escape dest or overwrite
+    an earlier file.
+    """
+    dest.mkdir(parents=True, exist_ok=True)
+    saved: list[Path] = []
+    for i, part in enumerate(msg.iter_attachments()):
+        name = Path(part.get_filename() or f"attachment-{i + 1}").name
+        if not name or name in (".", ".."):
+            name = f"attachment-{i + 1}"
+        target = dest / name
+        stem, suffix = target.stem, target.suffix
+        n = 1
+        while target.exists():
+            target = dest / f"{stem}-{n}{suffix}"
+            n += 1
+        payload = part.get_payload(decode=True)
+        if payload is None:
+            content = part.get_content()
+            payload = content.encode() if isinstance(content, str) else bytes(content)
+        target.write_bytes(payload)
+        saved.append(target)
+    return saved

email_cli_tool-0.3.1/src/emailcli/skill_install.py

@@ -0,0 +1,71 @@
+from dataclasses import dataclass
+from importlib.resources import files
+from pathlib import Path
+from typing import Literal
+
+SKILL_NAMES = ["send-email", "wait-email"]
+
+# target name -> home subdirectory that holds the agent's skills
+TARGET_HOME_DIRS = {
+    "claude": ".claude",
+    "codex": ".codex",
+}
+
+# human-facing label per target
+TARGET_LABELS = {
+    "claude": "Claude",
+    "codex": "Codex",
+}
+
+
+def load_skill_content(skill_name: str) -> str:
+    """Read a bundled SKILL.md shipped as package data."""
+    return (
+        files("emailcli")
+        .joinpath(f"skills/{skill_name}/SKILL.md")
+        .read_text(encoding="utf-8")
+    )
+
+
+def skill_dest(home: Path, target: str, skill_name: str) -> Path:
+    """Destination SKILL.md path for a target under the given home dir."""
+    return home / TARGET_HOME_DIRS[target] / "skills" / skill_name / "SKILL.md"
+
+
+@dataclass
+class InstallResult:
+    target: str
+    skill: str
+    path: Path
+    status: Literal["created", "updated", "failed"]
+    error: str | None = None
+
+
+def install_skill(home: Path, targets: list[str]) -> list[InstallResult]:
+    """Write the bundled skills into each target's user-level skills dir.
+
+    Each (target, skill) pair is handled independently; a write failure on
+    one does not stop the others.
+    """
+    unknown = [t for t in targets if t not in TARGET_HOME_DIRS]
+    if unknown:
+        raise ValueError(f"Unknown target(s): {', '.join(unknown)}")
+    contents = {name: load_skill_content(name) for name in SKILL_NAMES}
+    results: list[InstallResult] = []
+    for target in targets:
+        for skill_name in SKILL_NAMES:
+            dest = skill_dest(home, target, skill_name)
+            try:
+                existed = dest.exists()
+                dest.parent.mkdir(parents=True, exist_ok=True)
+                dest.write_text(contents[skill_name], encoding="utf-8")
+                results.append(
+                    InstallResult(
+                        target, skill_name, dest, "updated" if existed else "created"
+                    )
+                )
+            except OSError as exc:
+                results.append(
+                    InstallResult(target, skill_name, dest, "failed", str(exc))
+                )
+    return results