newsletter-events-remove-source

Remove Instagram accounts or web aggregators from sources.yaml configuration

⭐7stars🔀5forks📁View on GitHub🕐Updated Dec 26, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill provides an automated and safe way to manage local configuration files by removing specific Instagram accounts and web aggregators from the `sources.yaml` file. It streamlines the maintenance of media tracking tools by supporting multiple identifier types—such as handles, URLs, and names—while ensuring system stability through automatic backups, schema validation, and orphaned reference cleanup.

Use Cases

  • Case 1: Cleaning up inactive or irrelevant Instagram sources from a local event tracking configuration using simple @handles or names.
  • Case 2: Removing outdated or broken web aggregator URLs to maintain the accuracy of automated newsletter data sources.
  • Case 3: Performing bulk deletions of multiple sources simultaneously with built-in safety confirmations to prevent accidental data loss.
  • Case 4: Automating configuration hygiene by identifying and removing orphaned references in priority lists whenever a primary source is deleted.
namenewsletter-events-remove-source
descriptionRemove Instagram accounts or web aggregators from sources.yaml configuration
## Configuration Location

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

Identifier Matching

Input Matches
@handle Instagram account by handle
handle (no @) Instagram account by handle
https://site.com Web aggregator by URL
"Page Name" Any source by name (asks if ambiguous)

Note: Facebook events are not stored in configuration, so there's nothing to remove.

Safety Features

  • Automatic backup before removal
  • Validation after removal
  • Automatic rollback if validation fails
  • Orphan reference cleanup (priority_handles)
What sources do you want to remove?

Examples:

  • @localvenue - Remove Instagram account
  • @venue1 @venue2 - Remove multiple Instagram accounts
  • https://events.com - Remove web aggregator
  • "Local Venue" - Remove by name (any type)

Provide the source(s) to remove:

## Step 1: Parse Identifiers

Analyze the user's input to extract sources to remove:

Instagram detection:

  • Starts with @ → Instagram handle
  • Word that looks like a handle (alphanumeric + underscores) → Instagram handle

Web Aggregator detection:

  • Any URL (http:// or https://) → Web aggregator

Name detection:

  • Quoted string → Search by name across all types

Extract multiple sources:

  • Split on commas, "and", spaces, newlines
  • Deduplicate

Step 2: Load Current 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: Match Sources

For each identifier, find matches:

def find_matches(identifier: str, config: dict) -> list:
    """
    Match priority:
    1. Exact Instagram handle (case-insensitive)
    2. Exact Web URL (normalized)
    3. Exact name match (any type)
    """
    matches = []
    normalized = identifier.lower().lstrip("@").strip('"\'')
    sources = config.get("sources", {})

    # Check Instagram handles
    for account in sources.get("instagram", {}).get("accounts", []):
        if account["handle"].lower() == normalized:
            matches.append({"type": "instagram", "item": account, "match": "handle"})

    # Check Web aggregators
    for source in sources.get("web_aggregators", {}).get("sources", []):
        if normalized in source["url"].lower():
            matches.append({"type": "web", "item": source, "match": "url"})

    # Check names (all types) if no URL/handle matches
    if not matches:
        for account in sources.get("instagram", {}).get("accounts", []):
            if account.get("name", "").lower() == normalized:
                matches.append({"type": "instagram", "item": account, "match": "name"})
        for source in sources.get("web_aggregators", {}).get("sources", []):
            if source.get("name", "").lower() == normalized:
                matches.append({"type": "web", "item": source, "match": "name"})

    return matches

Step 4: Handle Ambiguity

If an identifier matches multiple sources, ask the user to clarify:

Multiple sources match 'venue':
1. @venue (Instagram) - Local Venue
2. https://venue.com (Web) - Venue Events

Which one(s) to remove? (Enter numbers separated by commas, or 'all'):

Step 5: Confirm if Large Batch

If removing 4+ sources, ask for confirmation:

About to remove 5 sources:
- @localvenue (Instagram)
- @oldbar (Instagram)
- @closedgallery (Instagram)
- https://defunctsite.com (Web)
- https://oldsite.com (Web)

This cannot be undone. Continue? (y/n):

Step 6: Backup Original Config

import shutil
from datetime import datetime

backup_path = config_path.with_suffix(f".yaml.{datetime.now():%Y%m%d%H%M%S}.backup")
shutil.copy2(config_path, backup_path)

Step 7: Remove Sources

removed = []
not_found = []

for identifier, matches in matched_sources.items():
    if not matches:
        not_found.append(identifier)
        continue

    for match in matches:
        if match["type"] == "instagram":
            config["sources"]["instagram"]["accounts"] = [
                a for a in config["sources"]["instagram"]["accounts"]
                if a["handle"].lower() != match["item"]["handle"].lower()
            ]
        elif match["type"] == "web":
            config["sources"]["web_aggregators"]["sources"] = [
                s for s in config["sources"]["web_aggregators"]["sources"]
                if s["url"].lower() != match["item"]["url"].lower()
            ]
        removed.append(match)

Step 8: Clean Orphaned References

If removing an Instagram account, also clean up priority_handles:

# Get remaining handles
remaining_handles = {
    a["handle"].lower()
    for a in config["sources"]["instagram"]["accounts"]
}

# Clean priority_handles
if "priority_handles" in config["sources"]["instagram"]:
    original_priority = config["sources"]["instagram"]["priority_handles"]
    config["sources"]["instagram"]["priority_handles"] = [
        h for h in original_priority
        if h.lower() in remaining_handles
    ]
    cleaned_priority = set(original_priority) - set(config["sources"]["instagram"]["priority_handles"])
    if cleaned_priority:
        print(f"Also removed from priority_handles: {', '.join(cleaned_priority)}")

Step 9: Validate Config

from config.config_schema import AppConfig

try:
    AppConfig.from_yaml(config_path)
except Exception as e:
    # Restore backup
    shutil.copy2(backup_path, config_path)
    print(f"ERROR: Invalid config after removal. Restored backup. Error: {e}")
    # STOP HERE

Step 10: Save Updated Config

with open(config_path, "w") as f:
    yaml.dump(config, f, default_flow_style=False, sort_keys=False, allow_unicode=True)

Step 11: Report Results

Display a summary:

Removing sources...

✓ Removed @localvenue (Local Venue) from Instagram accounts
✓ Removed @oldbar (Old Bar) from Instagram accounts
  Also removed from priority_handles
✓ Removed https://oldsite.com (Old Site) from web aggregators
✗ Not found: @unknownhandle

Summary: 3 removed, 1 not found

Config backup: sources.yaml.20250120143022.backup
To undo: cp ~/.config/local-media-tools/sources.yaml.20250120143022.backup ~/.config/local-media-tools/sources.yaml

Remaining sources: 4 (run /newsletter-events:list-sources to view)
- [ ] All identifiers parsed correctly - [ ] Matches found using correct priority (handle > URL > name) - [ ] Ambiguous matches resolved with user - [ ] Config backed up before modification - [ ] Sources removed from correct sections - [ ] Orphaned references cleaned up (priority_handles) - [ ] Config validates after removal - [ ] Clear summary shown with removed/not-found counts - [ ] Undo instructions provided