HEX
Server: Apache/2.4.46 (Win64) OpenSSL/1.1.1j PHP/8.4.25
System: Windows NT DESKTOP-4TAV2RJ 10.0 build 19045 (Windows 10) AMD64
User: fred (0)
PHP: 8.4.25
Disabled: NONE
Upload Files
File: C:/Users/fred/.codex/.tmp/plugins/plugins/hugging-face/skills/jobs/index.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>hf-jobs - Run Workloads on Hugging Face Jobs</title>
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }
        
        body {
            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
            line-height: 1.6;
            color: #333;
            background: #f5f5f5;
            padding: 20px;
        }
        
        .container {
            max-width: 1200px;
            margin: 0 auto;
            background: white;
            padding: 40px;
            border-radius: 8px;
            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
        }
        
        h1 {
            color: #ffd21e;
            background: #000;
            padding: 20px;
            margin: -40px -40px 30px -40px;
            border-radius: 8px 8px 0 0;
        }
        
        h2 {
            color: #1e1e1e;
            margin-top: 30px;
            margin-bottom: 15px;
            padding-bottom: 10px;
            border-bottom: 2px solid #ffd21e;
        }
        
        h3 {
            color: #555;
            margin-top: 20px;
            margin-bottom: 10px;
        }
        
        .description {
            background: #f9f9f9;
            padding: 20px;
            border-left: 4px solid #ffd21e;
            margin-bottom: 30px;
            border-radius: 4px;
        }
        
        .file-list {
            list-style: none;
            padding: 0;
        }
        
        .file-list li {
            padding: 12px;
            margin: 8px 0;
            background: #f9f9f9;
            border-radius: 4px;
            border-left: 3px solid #ffd21e;
            transition: background 0.2s;
        }
        
        .file-list li:hover {
            background: #f0f0f0;
        }
        
        .file-list a {
            color: #0066cc;
            text-decoration: none;
            font-weight: 500;
            display: block;
        }
        
        .file-list a:hover {
            text-decoration: underline;
        }
        
        .file-path {
            color: #666;
            font-size: 0.9em;
            font-family: 'Monaco', 'Courier New', monospace;
            margin-top: 4px;
        }
        
        .file-description {
            color: #777;
            font-size: 0.9em;
            margin-top: 4px;
            font-style: italic;
        }
        
        .metadata {
            background: #f0f0f0;
            padding: 15px;
            border-radius: 4px;
            margin-bottom: 30px;
        }
        
        .metadata p {
            margin: 5px 0;
        }
        
        .metadata strong {
            color: #333;
        }
        
        .section {
            margin-bottom: 40px;
        }
        
        code {
            background: #f4f4f4;
            padding: 2px 6px;
            border-radius: 3px;
            font-family: 'Monaco', 'Courier New', monospace;
            font-size: 0.9em;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>Agent Skill : hf-jobs</h1>
        
        <div class="description">
            <p><strong>Run any workload on Hugging Face Jobs.</strong></p>
            <p>Use this skill when you want to run GPU/CPU workloads (batch inference, synthetic data generation, dataset stats, experiments) on Hugging Face Jobs, with correct token handling and result persistence back to the Hub.</p>
        </div>
        
        <div class="metadata">
            <p><strong>Skill Name:</strong> hf-jobs</p>
            <p><strong>Main Documentation:</strong> <a href="jobs/SKILL.md">jobs/SKILL.md</a></p>
            <p><strong>Scripts Directory:</strong> <code>jobs/scripts/</code></p>
            <p><strong>References Directory:</strong> <code>jobs/references/</code></p>
        </div>
        
        <div class="section">
            <h2>Overview</h2>
            <p>This skill focuses on running real workloads via Hugging Face Jobs. It includes ready-to-run UV scripts and guides for authentication (HF tokens), secrets vs env vars, timeouts, hardware selection, and pushing results to the Hub.</p>
        </div>

        <div class="section">
            <h2>Core Documentation</h2>
            <ul class="file-list">
                <li>
                    <a href="jobs/SKILL.md">SKILL.md</a>
                    <div class="file-path">jobs/SKILL.md</div>
                    <div class="file-description">Complete skill documentation (how to submit jobs, tokens/secrets, timeouts, persistence, and how to use the bundled scripts)</div>
                </li>
            </ul>
        </div>

        <div class="section">
            <h2>References</h2>
            <ul class="file-list">
                <li>
                    <a href="jobs/references/token_usage.md">token_usage.md</a>
                    <div class="file-path">jobs/references/token_usage.md</div>
                    <div class="file-description">Token best practices: secrets vs env, permissions, common errors (401/403), and secure patterns</div>
                </li>
                <li>
                    <a href="jobs/references/hub_saving.md">hub_saving.md</a>
                    <div class="file-path">jobs/references/hub_saving.md</div>
                    <div class="file-description">How to persist results: push datasets/models/files to the Hub (ephemeral job filesystem)</div>
                </li>
                <li>
                    <a href="jobs/references/hardware_guide.md">hardware_guide.md</a>
                    <div class="file-path">jobs/references/hardware_guide.md</div>
                    <div class="file-description">Flavor selection guidance for CPU/GPU/TPU workloads</div>
                </li>
                <li>
                    <a href="jobs/references/troubleshooting.md">troubleshooting.md</a>
                    <div class="file-path">jobs/references/troubleshooting.md</div>
                    <div class="file-description">Common failure modes (timeouts, missing deps, OOM, auth) and fixes</div>
                </li>
            </ul>
        </div>

        <div class="section">
            <h2>Scripts</h2>
            <ul class="file-list">
                <li>
                    <a href="jobs/scripts/generate-responses.py">generate-responses.py</a>
                    <div class="file-path">jobs/scripts/generate-responses.py</div>
                    <div class="file-description">vLLM batch generation: load prompts/messages from a dataset, generate responses, push dataset + card to Hub</div>
                </li>
                <li>
                    <a href="jobs/scripts/cot-self-instruct.py">cot-self-instruct.py</a>
                    <div class="file-path">jobs/scripts/cot-self-instruct.py</div>
                    <div class="file-description">CoT Self-Instruct synthetic data generation (reasoning/instruction) + optional filtering, pushes dataset + card</div>
                </li>
                <li>
                    <a href="jobs/scripts/finepdfs-stats.py">finepdfs-stats.py</a>
                    <div class="file-path">jobs/scripts/finepdfs-stats.py</div>
                    <div class="file-description">Polars streaming stats over Hub parquet (finepdfs-edu); optional upload of computed stats to a dataset repo</div>
                </li>
            </ul>
        </div>
    </div>
</body>
</html>