newsletter-events-list-sources

List all configured event sources (Instagram, web aggregators)

newsletter
events
list
sources

SKILL.md

GitHub
<essential_principles> ## Configuration Location

All sources are stored in ~/.config/local-media-tools/sources.yaml.

Source Types

Type Filter Keyword Description
Instagram instagram, ig @handle accounts
Web web Event aggregator websites

Note: Facebook events are not configured sources. Pass event URLs directly to /research.

Output Format

Sources are displayed in grouped tables with relevant metadata for each type. </essential_principles>

<intake> What sources do you want to list?

Options:

  • all or blank - Show all configured sources
  • instagram - Only Instagram accounts
  • web - Only web aggregators

Provide filter (or press Enter for all): </intake>

<process> ## Step 1: Parse Filter

Check if user provided a filter keyword:

filter_input = user_input.strip().lower()

# Normalize filter aliases
filter_map = {
    "": "all",
    "all": "all",
    "instagram": "instagram",
    "ig": "instagram",
    "web": "web",
}

selected_filter = filter_map.get(filter_input, "all")

Step 2: Load Config

from pathlib import Path
import yaml

config_path = Path.home() / ".config" / "local-media-tools" / "sources.yaml"

if not config_path.exists():
    print("ERROR: sources.yaml not found. Run /newsletter-events:setup first.")
    # STOP HERE

with open(config_path) as f:
    config = yaml.safe_load(f)

Step 3: Extract Sources

sources = config.get("sources", {})

instagram_accounts = sources.get("instagram", {}).get("accounts", [])
web_sources = sources.get("web_aggregators", {}).get("sources", [])

Step 4: Check for Empty State

total_sources = len(instagram_accounts) + len(web_sources)

if total_sources == 0:
    print("No sources configured.")
    print("")
    print("To add sources: /newsletter-events:add-source @handle")
    # STOP HERE

Step 5: Format and Display Tables

Display each category with appropriate columns:

Instagram Accounts:

Handle Name Type Location
@localvenue Local Venue music_venue Kingston, NY
@themusicbar The Music Bar bar -

Web Aggregators:

URL Name Type Max Pages
https://hvmag.com/events HV Magazine listing 50

Step 6: Show Summary

Total: N sources configured
- Instagram: X accounts
- Web: Y aggregators

To add sources: /newsletter-events:add-source @handle
To remove sources: /newsletter-events:remove-source @handle

Note: For Facebook events, pass URLs directly to /research

Handling Filtered Views

If a filter was applied but that category is empty:

No instagram sources found.

You have:
- 1 web aggregator

To add Instagram accounts: /newsletter-events:add-source @handle
</process> <success_criteria> - [ ] Config loaded successfully - [ ] Filter applied correctly (if provided) - [ ] Output formatted as readable tables - [ ] Empty states handled with helpful messages - [ ] Summary shows totals - [ ] Next actions suggested </success_criteria>