Skip to content

AgriciDaniel/claude-youtube / skills/claude-youtube

youtube

Verified

The ultimate YouTube creator skill. Covers channel audits, video SEO, retention-engineered scripts, hook writing, thumbnail briefs, content strategy, content calendars, Shorts optimisation, analytics interpretation, monetisation planning, competitor research, cross-platform repurposing, upload metadata packages, and data-driven video idea generation. Triggers on: "youtube", "channel", "video", "views", "subscribers", "watch time", "shorts", "thumbnail", "CTR", "retention", "monetize", "script", "hook", "upload", "youtube audit", "video ideas", "content calendar", "competitor analysis", "repurpose video", "youtube seo", "youtube strategy", "youtube analytics".

FileKindSize
SKILL.mdskill md12.2 KB
execution/fetch_channel_data.pyscript8.2 KB
execution/fetch_transcript.pyscript7.5 KB
execution/fetch_video_analytics.pyscript6.6 KB
execution/search_competitor_videos.pyscript7.0 KB
execution/utils/quota_tracker.pyscript5.8 KB
execution/utils/youtube_auth.pyscript5.7 KB
references/algorithm-guide.mdmarkdown6.3 KB
references/analytics-guide.mdmarkdown5.9 KB
references/dataforseo-integration.mdmarkdown12.8 KB
references/monetization-guide.mdmarkdown5.9 KB
references/repurposing-guide.mdmarkdown6.3 KB
references/retention-scripting-guide.mdmarkdown8.0 KB
references/seo-playbook.mdmarkdown6.0 KB
references/shorts-playbook.mdmarkdown5.2 KB
references/thumbnail-ctr-guide.mdmarkdown6.6 KB
sub-skills/analyze.mdmarkdown7.6 KB
sub-skills/audit.mdmarkdown8.9 KB
sub-skills/calendar.mdmarkdown8.6 KB
sub-skills/competitor.mdmarkdown10.2 KB
sub-skills/hook.mdmarkdown7.9 KB
sub-skills/ideate.mdmarkdown8.5 KB
sub-skills/metadata.mdmarkdown8.3 KB
sub-skills/monetize.mdmarkdown7.3 KB
sub-skills/repurpose.mdmarkdown6.7 KB
sub-skills/script.mdmarkdown7.1 KB
sub-skills/seo.mdmarkdown7.7 KB
sub-skills/shorts.mdmarkdown5.2 KB
sub-skills/strategy.mdmarkdown9.8 KB
sub-skills/thumbnail.mdmarkdown9.9 KB
templates/commentary-channel.mdmarkdown6.5 KB
templates/education-channel.mdmarkdown4.8 KB
templates/entertainment-channel.mdmarkdown5.5 KB
templates/niche-authority-channel.mdmarkdown7.8 KB
templates/personal-brand-channel.mdmarkdown8.3 KB
templates/review-channel.mdmarkdown6.3 KB
templates/shorts-first-channel.mdmarkdown8.4 KB
templates/tutorial-channel.mdmarkdown5.7 KB
templates/vlog-channel.mdmarkdown6.0 KB

execution/utils/quota_tracker.py

View on GitHub
"""
YouTube Data API v3 quota tracker.

Tracks unit consumption per operation and warns before quota exhaustion.
Daily quota: 10,000 units, resets at midnight Pacific Time.

Quota costs:
    search.list    = 100 units
    videos.list    = 1 unit
    channels.list  = 1 unit
    playlistItems.list = 1 unit
    commentThreads.list = 1 unit
    videos.insert  = 100 units

Usage:
    python execution/utils/quota_tracker.py --check
    python execution/utils/quota_tracker.py --consume search.list
    python execution/utils/quota_tracker.py --consume videos.list --count 10
    python execution/utils/quota_tracker.py --reset
"""

import argparse
import json
import sys
from datetime import datetime, timezone, timedelta
from pathlib import Path

TMP_DIR = Path.home() / ".claude" / ".tmp"
DAILY_QUOTA = 10000
WARN_THRESHOLD = 0.80  # Warn at 80% consumed

OPERATION_COSTS = {
    "search.list": 100,
    "videos.list": 1,
    "channels.list": 1,
    "playlistItems.list": 1,
    "commentThreads.list": 1,
    "captions.list": 1,
    "playlists.list": 1,
    "videos.insert": 100,
}

PACIFIC_OFFSET = timedelta(hours=-8)  # PST (approximate; doesn't handle DST)


def _pacific_date():
    """Return current date in Pacific Time."""
    utc_now = datetime.now(timezone.utc)
    pacific_now = utc_now + PACIFIC_OFFSET
    return pacific_now.strftime("%Y-%m-%d")


def _quota_file():
    """Return path to today's quota file."""
    TMP_DIR.mkdir(parents=True, exist_ok=True)
    return TMP_DIR / f"youtube_quota_{_pacific_date()}.json"


def _load_quota():
    """Load today's quota state."""
    path = _quota_file()
    if path.exists():
        with open(path) as f:
            return json.load(f)
    return {"date": _pacific_date(), "consumed": 0, "operations": {}}


def _save_quota(data):
    """Save quota state."""
    path = _quota_file()
    with open(path, "w") as f:
        json.dump(data, f, indent=2)


def get_remaining():
    """Return remaining quota units for today."""
    data = _load_quota()
    return DAILY_QUOTA - data["consumed"]


def check_quota(operation=None, count=1):
    """Check if an operation can be performed within quota.

    Returns dict with status, remaining units, and warning if applicable.
    """
    data = _load_quota()
    remaining = DAILY_QUOTA - data["consumed"]
    used_pct = data["consumed"] / DAILY_QUOTA

    result = {
        "date": data["date"],
        "consumed": data["consumed"],
        "remaining": remaining,
        "daily_quota": DAILY_QUOTA,
        "used_percent": round(used_pct * 100, 1),
    }

    if used_pct >= WARN_THRESHOLD:
        result["warning"] = (
            f"Quota {result['used_percent']}% consumed. "
            f"Only {remaining} units remaining. Use sparingly."
        )

    if operation:
        cost = OPERATION_COSTS.get(operation, 0)
        total_cost = cost * count
        result["operation"] = operation
        result["operation_cost"] = total_cost
        result["can_execute"] = total_cost <= remaining

        if not result["can_execute"]:
            result["error"] = (
                f"Operation {operation} (×{count}) costs {total_cost} units "
                f"but only {remaining} remaining. Defer to tomorrow."
            )

    return result


def consume_quota(operation, count=1):
    """Record quota consumption for an operation.

    Returns dict with updated quota state.
    """
    cost = OPERATION_COSTS.get(operation, 0)
    if cost == 0:
        return {"warning": f"Unknown operation '{operation}'. No quota consumed."}

    total_cost = cost * count
    data = _load_quota()
    remaining = DAILY_QUOTA - data["consumed"]

    if total_cost > remaining:
        return {
            "error": f"Quota exceeded. Need {total_cost} units, only {remaining} available.",
            "remaining": remaining,
            "consumed": data["consumed"],
        }

    data["consumed"] += total_cost
    op_key = operation
    data["operations"][op_key] = data["operations"].get(op_key, 0) + count
    _save_quota(data)

    new_remaining = DAILY_QUOTA - data["consumed"]
    result = {
        "operation": operation,
        "units_consumed": total_cost,
        "remaining": new_remaining,
        "used_percent": round(data["consumed"] / DAILY_QUOTA * 100, 1),
    }

    if data["consumed"] / DAILY_QUOTA >= WARN_THRESHOLD:
        result["warning"] = (
            f"Quota {result['used_percent']}% consumed. "
            f"Only {new_remaining} units remaining."
        )

    return result


def reset_quota():
    """Force reset today's quota (for testing only)."""
    data = {"date": _pacific_date(), "consumed": 0, "operations": {}}
    _save_quota(data)
    return {"status": "reset", "date": data["date"], "remaining": DAILY_QUOTA}


def main():
    parser = argparse.ArgumentParser(description="YouTube API quota tracker")
    parser.add_argument("--check", action="store_true",
                        help="Check current quota status")
    parser.add_argument("--consume", type=str,
                        help="Record quota consumption for an operation")
    parser.add_argument("--count", type=int, default=1,
                        help="Number of operations (default: 1)")
    parser.add_argument("--reset", action="store_true",
                        help="Reset quota counter (testing only)")
    parser.add_argument("--can-afford", type=str,
                        help="Check if operation is affordable")
    args = parser.parse_args()

    if args.reset:
        result = reset_quota()
    elif args.consume:
        result = consume_quota(args.consume, args.count)
    elif args.can_afford:
        result = check_quota(args.can_afford, args.count)
    elif args.check:
        result = check_quota()
    else:
        parser.print_help()
        return

    print(json.dumps(result, indent=2))
    if "error" in result:
        sys.exit(1)


if __name__ == "__main__":
    main()
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall