Skip to content

anbeime/skill / skills/email-concierge

email-concierge

Verified

Local AI email assistant that automates unread-mail processing, offline-safe classification and reply drafting, local draft editing/approval queues, calendar conflict checks, voice transcription, and confirmed SMTP sending when connectivity returns. Use when the user wants to manage email, check inbox, draft or edit replies, queue messages offline, approve/send email, handle meeting invites, or mentions email assistant, IMAP, SMTP, voice memo, local AI email.

FileKindSize
.gitignoreother67 B
.qoderignoreother154 B
SKILL.mdskill md13.4 KB
email_concierge.pyscript62.1 KB
email_concierge_config.jsonconfig426 B
install_qoder.batscript380 B
install_qoder.ps1script1.4 KB
install_qoder.shscript779 B
install_skill.pyscript6.0 KB
qoder.jsonconfig1019 B
requirements-core.txtmarkdown102 B
requirements-openvino.txtmarkdown140 B
requirements.txtmanifest165 B
setup.batscript182 B
setup.shscript170 B
setup_auto.pyscript16.3 KB

install_skill.py

View on GitHub
#!/usr/bin/env python3
"""Install this skill for Qoder or Codex on Windows, macOS, and Linux.

The installer copies the skill into the target application's skill directory,
preserves an existing mail configuration, and optionally runs the automated
setup bootstrapper.
"""
import argparse
import fnmatch
import json
import os
import shutil
import subprocess
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parent


def destination_is_inside_source(source: Path, destination: Path) -> bool:
    """Return whether copying would recursively copy an install into itself."""
    try:
        destination.relative_to(source)
        return True
    except ValueError:
        return False


def _is_first_install(destination: Path) -> bool:
    """Return True if no setup-completed marker exists in the destination."""
    return not (destination / "state" / ".setup_completed.json").exists()


def read_ignore_patterns(path: Path) -> list[str]:
    """Read newline-separated ignore patterns from a file."""
    if not path.exists():
        return []
    return [line.strip() for line in path.read_text(encoding="utf-8").splitlines() if line.strip() and not line.startswith("#")]


def should_include(name: str, ignores: list[str]) -> bool:
    """Return False if a file or directory name matches an ignore pattern."""
    for pattern in ignores:
        normalized = pattern.rstrip("/")
        if fnmatch.fnmatch(name, normalized) or name == normalized or name.startswith(normalized + os.sep):
            return False
    return True


def copy_skill(source: Path, destination: Path, ignores: list[str]) -> list[str]:
    """Copy skill files while preserving an existing config and honouring ignores."""
    copied: list[str] = []
    destination.mkdir(parents=True, exist_ok=True)

    for item in source.iterdir():
        if not should_include(item.name, ignores):
            continue
        target = destination / item.name
        if item.is_dir():
            # Merge directories so a user's state/config and future runtime
            # files survive an upgrade. Individual skill files are replaced.
            target.mkdir(parents=True, exist_ok=True)
            nested_ignores = ignores
            for child in item.rglob("*"):
                relative = child.relative_to(item)
                if any(not should_include(part, nested_ignores) for part in relative.parts):
                    continue
                child_target = target / relative
                if child.is_dir():
                    child_target.mkdir(parents=True, exist_ok=True)
                else:
                    child_target.parent.mkdir(parents=True, exist_ok=True)
                    shutil.copy2(child, child_target)
            copied.append(str(target.relative_to(destination)))
        else:
            if item.name == "email_concierge_config.json" and target.exists():
                continue
            shutil.copy2(item, target)
            copied.append(item.name)

    # Ensure runtime directories exist.
    (destination / "state").mkdir(parents=True, exist_ok=True)
    return copied


def main() -> int:
    parser = argparse.ArgumentParser(description="Install Email Concierge skill")
    parser.add_argument("--target", choices=("qoder", "codex"), default="qoder")
    parser.add_argument("--destination")
    parser.add_argument("--setup", dest="setup", action="store_true", help="Run automatic dependency setup (default)")
    parser.add_argument("--no-setup", dest="setup", action="store_false", help="Copy files without installing dependencies")
    parser.add_argument("--first-install", dest="first_install", action="store_true", default=None,
                        help="Treat as first install (allows system package manager installs)")
    parser.add_argument("--no-first-install", dest="first_install", action="store_false",
                        help="Treat as subsequent install")
    parser.add_argument("--json", action="store_true", help="Output structured result as JSON")
    parser.set_defaults(setup=True)
    args = parser.parse_args()

    base = Path(args.destination).expanduser() if args.destination else Path.home() / f".{args.target}" / "skills"
    destination = (base / "email-concierge").resolve()
    if destination_is_inside_source(ROOT, destination):
        parser.error("--destination must be outside the source skill directory")

    is_first = args.first_install if args.first_install is not None else _is_first_install(destination)

    ignores = read_ignore_patterns(ROOT / ".qoderignore")
    copied = copy_skill(ROOT, destination, ignores)

    result = {
        "target": args.target,
        "destination": str(destination),
        "copied": copied,
        "setup_run": False,
        "setup_result": None,
        "error": "",
    }

    if args.setup:
        result["setup_run"] = True
        try:
            setup_script = destination / "setup_auto.py"
            setup_cmd = [
                sys.executable, str(setup_script),
                "--project-dir", str(destination),
                "--yes", "--json",
            ]
            if is_first:
                setup_cmd.append("--first-install")
            completed = subprocess.run(
                setup_cmd, capture_output=True, text=True, check=False,
            )
            result["setup_result"] = completed.returncode
            result["setup_stdout"] = completed.stdout[-4000:]
            result["setup_stderr"] = completed.stderr[-4000:]
            if completed.returncode != 0:
                result["error"] = "setup_auto.py returned a non-zero exit code"
        except OSError as error:
            result["error"] = str(error)

    if args.json:
        print(json.dumps(result, ensure_ascii=False))
    else:
        print(f"Installed {args.target} skill to {destination}")
        if args.setup and result["setup_result"] != 0:
            print("Setup reported a non-zero exit code; run setup manually if needed.")

    return 0 if not result["error"] else 1


if __name__ == "__main__":
    raise SystemExit(main())
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall