SKILL.md
Poffice Admin Skill
This skill provides the necessary tools and workflows to manage the Poffice infrastructure.
Core Capabilities
- User & Mail Management: Create mailboxes, manage domains, and send/receive emails.
- Document Management: Sync files via Seafile and archive documents via Paperless-ngx.
- Calendar Management: Full CRUD management of events (List, Add, Update, Delete) in SOGo (attached to Mailcow) and sending email invites with .ics attachments.
- Document Creation: Generate and update Word (.docx), Excel (.xlsx), and PDF documents programmatically.
Quick Reference Scripts
The following scripts are available in the scripts/ directory:
poffice_mail.py: Mailbox creation and email sending.
poffice_docs.py: Seafile user and repo management.
poffice_paperless.py: Document ingestion and listing.
poffice_gen.py: Document creation and update (Word, Excel, PDF).
poffice_calendar.py: Calendar event creation and email invites.
Typical Workflows
Creating a New Office User
To create a fully provisioned user (Mail + Cloud storage):
- Run
python3 scripts/pofficemail.py create-mailbox domain.com username "Full Name" password
- Run
python3 scripts/poffice_docs.py create-user [email protected] password
Creating and Archiving a Report
- Use
poffice_gen.py to create a PDF or Excel report.
- Use
poffice_paperless.py to upload the generated file for long-term archiving.
- Use
poffice_mail.py to email the report to the team.
Scheduling a Meeting and Sending Invites
- Use
poffice_calendar.py add to put the event on your own calendar.
- Use
poffice_calendar.py invite to send the official invitation to participants.
- Optionally, use
pofficegen.py to create a meeting agenda PDF and attach it to an email using pofficemail.py.
Managing Existing Events
- Use
poffice_calendar.py list to see upcoming events.
- Use
poffice_calendar.py delete [UID] to remove an event.
- Update events using the
updateevent method in pofficecalendar.py.
Sending a System Invite
Use poffice_mail.py send-email to notify users about account creation or meetings.
Service Access & Credentials
See [references/credentials.md](references/credentials.md) for API keys and endpoint information.
Calendar (SOGo)
Calendar management is handled through SOGo.
- URL:
https://mail.poffice.online/SOGo
- CalDAV:
https://mail.poffice.online/SOGo/dav/
To send invites programmatically, use standard ics generation and send via poffice_mail.py.
Documentation
- Mailcow API: [references/mailcowapi.md](references/mailcowapi.md)
- Seafile API: [references/seafileapi.md](references/seafileapi.md)
- Paperless API: [references/paperlessapi.md](references/paperlessapi.md)