Skills Guide

Gestion de courriels IMAP

VérifiéPrudence

Gérez les boîtes aux lettres IMAP : listez, lisez et supprimez des courriels avec des scripts Python et une configuration basée sur fichier.

Télécharger et utiliser
Spar Skills Guide Bot
ProductiviteIntermédiaire
27/07/2026
Claude Code
#imap#email-management#mail-client#python-script#automation

Recommandé pour

Claude CodeAutomatisation GitProduct managerProductivitéSolo / indie hacker

Synthèse automatique

Gère les e-mails IMAP via un script Python : liste des messages, lecture du contenu et suppression par UID.

Points forts

  • Fonctionne avec des fichiers de configuration pour plusieurs comptes
  • Décode les en-têtes RFC 2047 et les corps HTML/texte
  • Parse les corps pour extraire résumés, champs d'incident et URLs
  • Supporte les options de recherche et de filtrage par date

Limites

  • Nécessite un fichier de configuration local avec permissions strictes
  • Ne gère pas l'envoi d'e-mails ni les pièces jointes volumineuses
  • La suppression dépend du support IMAP du serveur
Quand l'utiliser

Utilisez cette compétence pour automatiser la consultation, l'analyse ou le nettoyage de vos boîtes mail IMAP.

Quand l'éviter

Évitez-la si vous avez besoin d'un client mail interactif complet ou si le serveur IMAP nécessite OAuth2 non configuré.

Analyse de sécurité

Prudence
Score qualité88/100

The skill uses Python to connect to IMAP servers, read, and delete emails. It requires sensitive credentials and can modify mailbox state, but all actions are legitimate and explicitly requested. No destructive or obfuscated payloads are present.

Points d'attention
  • •The skill requires a configuration file containing IMAP credentials, which if exposed could allow unauthorized email access.
  • •It provides a delete mode that permanently removes emails, but this is an intended feature and requires explicit user action.
Comment cette analyse est faite

Exemples

List recent emails
List the latest 10 emails from my default IMAP account using the managing-mails skill.
Read a specific email by UID
Read the full content of email UID 12345 from my inbox using the managing-mails skill, including HTML body.
Delete an email by UID
Delete the email with UID 67890 from my IMAP account using the managing-mails skill, without expunging immediately.

name: managing-mails description: IMAP 프로토콜로 메일함 목록 조회, 본문 읽기, UID 기반 삭제를 수행합니다. 메일 검색, RFC 2047 헤더 디코딩, 파일 기반 설정(MANAGING_MAIL_CONFIG_PATH 또는 --config)으로 메일을 관리해야 할 때 사용하세요. allowed-tools: Bash(python3:*), Read, Write

IMAP 메일 관리 스킬

IMAP 계정 정보를 파일로 로드하여 메일 목록 조회, 본문 읽기, 삭제를 처리합니다.

빠른 시작

  1. 설정 파일 준비
mkdir -p ~/.config/managing-mails
cp mails.example.toml ~/.config/managing-mails/mails.toml
chmod 700 ~/.config/managing-mails
chmod 600 ~/.config/managing-mails/mails.toml
export MANAGING_MAIL_CONFIG_PATH=~/.config/managing-mails/mails.toml
  1. 메일 목록 확인
python3 scripts/imap_read.py --mode list
  1. 특정 UID 본문 읽기
python3 scripts/imap_read.py --mode read --uid 12345
  1. 특정 UID 메일 삭제
python3 scripts/imap_read.py --mode delete --uid 12345

CLI 인터페이스

  • --mode list|read|delete (필수)
  • --account <name> (선택, 미지정 시 default_account)
  • --mailbox <name> (선택, 미지정 시 계정 기본값)
  • --since YYYY-MM-DD (선택, 미지정 시 계정별 default_since_days)
  • --limit N (기본 20)
  • --uid <uid> (mode=read|delete 필수)
  • --query "<search expr>" (선택)
  • --config <path> (선택, 지정 시 최우선)
  • MANAGING_MAIL_CONFIG_PATH (--config 미지정 시 필수 환경변수)
  • --include-html (mode=read에서 HTML 본문 포함)
  • --no-expunge (mode=delete에서 즉시 영구삭제 없이 \Deleted 플래그만 설정)

출력 형식

  • list: [{uid, date, from, subject, flags}]
  • read: {uid, headers, text_body, parsed_body, html_body?, attachments[]}
  • delete: {uid, deleted_flag_set, expunged, remaining_matches[]}

parsed_body는 사람이 읽기 쉬운 본문 파싱 결과를 제공합니다.

  • source: 파싱 원본(text/plain 또는 text/html)
  • summary: 주요 본문 요약(줄바꿈 유지)
  • incident_fields: 장애 문서에서 추출한 핵심 필드(작성자/서비스명/장애 원인/티켓 등)
  • urls: 본문에서 추출한 링크 목록

에러 코드

  • CONFIG_NOT_FOUND
  • CONFIG_PARSE_ERROR
  • CONFIG_SCHEMA_ERROR
  • CONFIG_PERMISSION_DENIED
  • ACCOUNT_NOT_FOUND
  • IMAP_CONNECT_ERROR
  • AUTH_FAILED
  • MAILBOX_NOT_FOUND
  • MESSAGE_NOT_FOUND
  • DELETE_FAILED

세부 동작은 아래 참조 문서를 따릅니다.

  • 제공자 특이사항: references/provider-quirks.md
  • 검색 레시피: references/search-recipes.md

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/imap-email-management-ms2s7bja/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/imap-email-management-ms2s7bja' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/imap-email-management-ms2s7bja/download' --output '.skill-downloads/imap-email-management-ms2s7bja/SKILL.md.part' && mv '.skill-downloads/imap-email-management-ms2s7bja/SKILL.md.part' '.skill-downloads/imap-email-management-ms2s7bja/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Outils déclarés par l’auteur (à vérifier dans votre agent) : Bash(python3:*), Read, Write

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/imap-email-management-ms2s7bja/SKILL.md' && test -s '.skill-downloads/imap-email-management-ms2s7bja/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/managing-mails' && cp -R '.skill-downloads/imap-email-management-ms2s7bja' '.claude/skills/managing-mails'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/imap-email-management-ms2s7bja'

openskills read 'imap-email-management-ms2s7bja'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/imap-email-management-ms2s7bja/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires

Lecteur PDF

Productivite

Lit et extrait le texte de fichiers PDF (rapports, contrats, tableurs). Gère les fichiers locaux, les URL et les pièces jointes WhatsApp. Utilisez-le dès qu'un contenu PDF est nécessaire, même sans demande explicite.

Claude CodeCursorCodexbeginnerSûr 20,122
Skills Guide Bot

Workflows de messagerie Discord

Productivite

Utilisez l'outil message pour envoyer, modifier et modérer des messages Discord avec des composants interactifs.

Claude CodeintermediateSûr 388,021
Skills Guide Bot

Aperçu interactif des verdicts

Productivite

Générer un aperçu HTML interactif des verdicts (garder/supprimer) pour la revue par le mainteneur, puis traiter le JSON de retour.

Claude CodeintermediateSûr 316,798
Skills Guide Bot