@synsci/cli-darwin-x64 1.1.49

package/bin/skills/hugging-face-paper-publisher/templates/modern.md

@@ -0,0 +1,319 @@
+---
+title: {{TITLE}}
+authors: {{AUTHORS}}
+date: {{DATE}}
+arxiv:
+tags: [machine-learning, ai]
+layout: modern
+---
+
+<div class="header">
+
+# {{TITLE}}
+
+<div class="authors">
+{{AUTHORS}}
+</div>
+
+<div class="date">
+{{DATE}}
+</div>
+
+<div class="links">
+[arXiv](#) · [PDF](#) · [Code](#) · [Demo](#)
+</div>
+
+</div>
+
+---
+
+## Abstract
+
+<div class="abstract">
+
+{{ABSTRACT}}
+
+</div>
+
+---
+
+## Introduction
+
+Modern research requires clear, accessible communication. This template provides a clean, web-friendly format inspired by Distill and modern scientific publications.
+
+<div class="key-insight">
+💡 **Key Insight**: Present your main contribution upfront to engage readers immediately.
+</div>
+
+### Why This Matters
+
+Explain the significance of your work in plain language. What real-world problems does it solve?
+
+### Our Approach
+
+Summarize your methodology at a high level before diving into details.
+
+---
+
+## Background
+
+<div class="definition">
+**Definition**: Clearly define key terms and concepts early in the paper.
+</div>
+
+Provide context necessary to understand your contribution without overwhelming readers with details.
+
+### Problem Statement
+
+Formally state the problem you're addressing.
+
+### Challenges
+
+What makes this problem difficult?
+
+1. **Challenge 1**: Description
+2. **Challenge 2**: Description
+3. **Challenge 3**: Description
+
+---
+
+## Method
+
+Present your approach with clear visual aids and intuitive explanations.
+
+<div class="figure">
+
+```
+[Diagram of your architecture goes here]
+```
+
+**Figure 1**: Overview of the proposed method. Caption explains the key components.
+
+</div>
+
+### Model Architecture
+
+Describe your model systematically:
+
+```python
+# Pseudocode example
+class YourModel:
+    def __init__(self):
+        self.encoder = Encoder()
+        self.decoder = Decoder()
+
+    def forward(self, x):
+        z = self.encoder(x)
+        output = self.decoder(z)
+        return output
+```
+
+### Training Strategy
+
+Explain how you train the model, including:
+
+- **Objective Function**: Mathematical formulation
+- **Optimization**: Algorithm and hyperparameters
+- **Regularization**: Techniques to prevent overfitting
+
+---
+
+## Experiments
+
+### Setup
+
+<div class="experiment-details">
+
+| Component | Configuration |
+|-----------|--------------|
+| **Dataset** | Name, Size, Split |
+| **Hardware** | GPU Type, RAM |
+| **Framework** | PyTorch 2.0, Transformers |
+| **Training Time** | Hours/Days |
+
+</div>
+
+### Results
+
+Present results clearly with tables and visualizations.
+
+<div class="results-table">
+
+| Model | Accuracy | F1 Score | Params | Speed |
+|-------|----------|----------|--------|-------|
+| Baseline | 85.2% | 0.84 | 100M | 100 tok/s |
+| **Ours** | **92.1%** | **0.91** | 120M | 95 tok/s |
+| SOTA | 90.5% | 0.89 | 300M | 60 tok/s |
+
+</div>
+
+<div class="insight">
+🔍 **Observation**: Our method achieves state-of-the-art performance with fewer parameters.
+</div>
+
+### Analysis
+
+Deep dive into what the results reveal:
+
+1. **Performance**: How does your method compare?
+2. **Efficiency**: What are the computational costs?
+3. **Robustness**: How does it perform across different scenarios?
+
+---
+
+## Ablation Study
+
+Systematically evaluate each component's contribution.
+
+<div class="ablation-results">
+
+| Configuration | Score | Δ |
+|---------------|-------|---|
+| Full Model | 92.1% | - |
+| - Component A | 89.3% | -2.8% |
+| - Component B | 90.1% | -2.0% |
+| - Component C | 91.5% | -0.6% |
+
+</div>
+
+**Conclusion**: All components contribute meaningfully, with Component A being most critical.
+
+---
+
+## Discussion
+
+### What We Learned
+
+Synthesize insights from your experiments.
+
+### Limitations
+
+<div class="limitations">
+
+⚠️ **Current Limitations**:
+
+1. Performance on domain X is limited
+2. Computational requirements are high
+3. Requires large training datasets
+
+</div>
+
+### Future Directions
+
+Where should the community go next?
+
+- **Direction 1**: Description
+- **Direction 2**: Description
+- **Direction 3**: Description
+
+---
+
+## Related Work
+
+Compare and contrast with existing methods.
+
+### Prior Approaches
+
+| Method | Year | Key Idea | Limitation |
+|--------|------|----------|------------|
+| Method A | 2020 | Approach 1 | Issue X |
+| Method B | 2021 | Approach 2 | Issue Y |
+| Method C | 2023 | Approach 3 | Issue Z |
+
+### How We Differ
+
+Clearly articulate what's novel about your work.
+
+---
+
+## Conclusion
+
+<div class="conclusion">
+
+We presented **{{TITLE}}**, which achieves:
+
+1. ✅ **Main contribution 1**
+2. ✅ **Main contribution 2**
+3. ✅ **Main contribution 3**
+
+Our results demonstrate [key finding], opening new directions for [future work].
+
+</div>
+
+---
+
+## Reproducibility
+
+<div class="reproducibility">
+
+### Code & Data
+
+- **Code**: [github.com/username/repo](#)
+- **Models**: [huggingface.co/username/model](#)
+- **Datasets**: [huggingface.co/datasets/username/dataset](#)
+- **Demo**: [huggingface.co/spaces/username/demo](#)
+
+### Citation
+
+```bibtex
+@article{yourpaper2025,
+  title={{{{TITLE}}}},
+  author={{{{AUTHORS}}}},
+  year={2025},
+  journal={arXiv preprint}
+}
+```
+
+</div>
+
+---
+
+## Acknowledgments
+
+Thank funding agencies, collaborators, and computing resources that made this work possible.
+
+---
+
+<div class="appendix">
+
+## Appendix
+
+### A. Additional Results
+
+Supplementary experiments and extended results.
+
+### B. Hyperparameters
+
+Complete training configuration:
+
+```yaml
+learning_rate: 1e-4
+batch_size: 32
+epochs: 100
+optimizer: AdamW
+scheduler: cosine
+warmup_steps: 1000
+```
+
+### C. Dataset Details
+
+Detailed information about datasets used.
+
+</div>
+
+---
+
+<style>
+.header { text-align: center; margin-bottom: 2em; }
+.authors { font-size: 1.2em; margin: 0.5em 0; }
+.date { color: #666; margin: 0.5em 0; }
+.links { margin-top: 1em; }
+.abstract { background: #f5f5f5; padding: 1.5em; border-radius: 8px; margin: 1em 0; }
+.key-insight, .insight { background: #e8f4f8; border-left: 4px solid #2196F3; padding: 1em; margin: 1em 0; }
+.definition { background: #fff3e0; border-left: 4px solid #ff9800; padding: 1em; margin: 1em 0; }
+.limitations { background: #ffebee; border-left: 4px solid #f44336; padding: 1em; margin: 1em 0; }
+.conclusion { background: #e8f5e9; border-left: 4px solid #4caf50; padding: 1.5em; margin: 1em 0; }
+.figure { text-align: center; margin: 2em 0; }
+.experiment-details, .results-table, .ablation-results { margin: 1em 0; }
+.reproducibility { background: #f5f5f5; padding: 1.5em; border-radius: 8px; margin: 2em 0; }
+</style>

package/bin/skills/hugging-face-paper-publisher/templates/standard.md

@@ -0,0 +1,201 @@
+---
+title: {{TITLE}}
+authors: {{AUTHORS}}
+date: {{DATE}}
+arxiv:
+tags: [machine-learning, deep-learning]
+---
+
+# {{TITLE}}
+
+**{{AUTHORS}}**
+
+*{{DATE}}*
+
+---
+
+## Abstract
+
+{{ABSTRACT}}
+
+---
+
+## 1. Introduction
+
+Provide background and motivation for your research. Explain:
+- What problem are you addressing?
+- Why is it important?
+- What is novel about your approach?
+
+### 1.1 Motivation
+
+Describe the real-world context and importance of the problem.
+
+### 1.2 Contributions
+
+List the main contributions of your work:
+1. First contribution
+2. Second contribution
+3. Third contribution
+
+---
+
+## 2. Related Work
+
+Survey previous research relevant to your work. Organize by:
+- Different approaches to the problem
+- Complementary methods
+- Alternative solutions
+
+### 2.1 Previous Approaches
+
+Discuss earlier methods and their limitations.
+
+### 2.2 Recent Advances
+
+Highlight recent developments in the field.
+
+---
+
+## 3. Background
+
+Provide necessary technical background for understanding your work.
+
+### 3.1 Problem Formulation
+
+Formally define the problem you're solving.
+
+### 3.2 Preliminaries
+
+Introduce key concepts, notation, and terminology.
+
+---
+
+## 4. Methodology
+
+Describe your approach in detail.
+
+### 4.1 Overview
+
+Provide a high-level description of your method.
+
+### 4.2 Model Architecture
+
+Detail the technical components of your system.
+
+### 4.3 Training Procedure
+
+Explain how the model is trained.
+
+### 4.4 Implementation Details
+
+Provide reproducibility information:
+- Hyperparameters
+- Hardware requirements
+- Software dependencies
+
+---
+
+## 5. Experiments
+
+Present your experimental setup and results.
+
+### 5.1 Datasets
+
+Describe the datasets used for evaluation.
+
+### 5.2 Evaluation Metrics
+
+Define the metrics used to assess performance.
+
+### 5.3 Baselines
+
+List comparison methods.
+
+### 5.4 Experimental Setup
+
+Detail the experimental configuration.
+
+---
+
+## 6. Results
+
+Present and analyze your findings.
+
+### 6.1 Main Results
+
+Report primary experimental results.
+
+| Model | Dataset | Metric | Score |
+|-------|---------|--------|-------|
+| Baseline | Dataset A | Accuracy | 0.85 |
+| Ours | Dataset A | Accuracy | 0.92 |
+
+### 6.2 Ablation Studies
+
+Analyze the contribution of different components.
+
+### 6.3 Qualitative Analysis
+
+Provide examples and case studies.
+
+---
+
+## 7. Discussion
+
+Interpret your results and discuss implications.
+
+### 7.1 Analysis
+
+What do the results tell us?
+
+### 7.2 Limitations
+
+Acknowledge limitations of your approach.
+
+### 7.3 Broader Impact
+
+Discuss societal implications and potential applications.
+
+---
+
+## 8. Conclusion
+
+Summarize your work and contributions.
+
+### 8.1 Summary
+
+Recap the main findings.
+
+### 8.2 Future Work
+
+Suggest directions for future research.
+
+---
+
+## Acknowledgments
+
+Thank collaborators, funding sources, and computational resources.
+
+---
+
+## References
+
+1. Author A, et al. "Paper Title." Conference/Journal, Year.
+2. Author B, et al. "Another Paper." Conference/Journal, Year.
+
+---
+
+## Appendix
+
+### A. Additional Experiments
+
+Supplementary experimental results.
+
+### B. Implementation Details
+
+Code snippets and configuration details.
+
+### C. Hyperparameters
+
+Complete list of hyperparameters used.

package/bin/skills/hugging-face-tool-builder/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: hugging-face-tool-builder
+description: Use this skill when the user wants to build tool/scripts or achieve a task where using data from the Hugging Face API would help. This is especially useful when chaining or combining API calls or the task will be repeated/automated. This Skill creates a reusable script to fetch, enrich or process data.
+version: 1.0.0
+author: Synthetic Sciences
+license: MIT
+tags: [Hugging Face, Tools, Agents, MCP]
+dependencies: [huggingface-hub, transformers]
+---
+
+# Hugging Face API Tool Builder
+
+Your purpose is now is to create reusable command line scripts and utilities for using the Hugging Face API, allowing chaining, piping and intermediate processing where helpful. You can access the API directly, as well as use the `hf` command line tool. Model and Dataset cards can be accessed from repositories directly.
+
+## Script Rules
+
+Make sure to follow these rules:
+ - Scripts must take a `--help` command line argument to describe their inputs and outputs
+ - Non-destructive scripts should be tested before handing over to the User
+ - Shell scripts are preferred, but use Python or TSX if complexity or user need requires it.
+ - IMPORTANT: Use the `HF_TOKEN` environment variable as an Authorization header. For example: `curl -H "Authorization: Bearer ${HF_TOKEN}" https://huggingface.co/api/`. This provides higher rate limits and appropriate authorization for data access.
+ - Investigate the shape of the API results before commiting to a final design; make use of piping and chaining where composability would be an advantage - prefer simple solutions where possible.
+ - Share usage examples once complete.
+
+Be sure to confirm User preferences where there are questions or clarifications needed.
+
+## Sample Scripts
+
+Paths below are relative to this skill directory.
+
+Reference examples:
+- `references/hf_model_papers_auth.sh` — uses `HF_TOKEN` automatically and chains trending → model metadata → model card parsing with fallbacks; it demonstrates multi-step API usage plus auth hygiene for gated/private content.
+- `references/find_models_by_paper.sh` — optional `HF_TOKEN` usage via `--token`, consistent authenticated search, and a retry path when arXiv-prefixed searches are too narrow; it shows resilient query strategy and clear user-facing help.
+- `references/hf_model_card_frontmatter.sh` — uses the `hf` CLI to download model cards, extracts YAML frontmatter, and emits NDJSON summaries (license, pipeline tag, tags, gated prompt flag) for easy filtering.
+
+Baseline examples (ultra-simple, minimal logic, raw JSON output with `HF_TOKEN` header):
+- `references/baseline_hf_api.sh` — bash
+- `references/baseline_hf_api.py` — python
+- `references/baseline_hf_api.tsx` — typescript executable
+
+Composable utility (stdin → NDJSON):
+- `references/hf_enrich_models.sh` — reads model IDs from stdin, fetches metadata per ID, emits one JSON object per line for streaming pipelines.
+
+Composability through piping (shell-friendly JSON output):
+- `references/baseline_hf_api.sh 25 | jq -r '.[].id' | references/hf_enrich_models.sh | jq -s 'sort_by(.downloads) | reverse | .[:10]'`
+- `references/baseline_hf_api.sh 50 | jq '[.[] | {id, downloads}] | sort_by(.downloads) | reverse | .[:10]'`
+- `printf '%s\n' openai/gpt-oss-120b meta-llama/Meta-Llama-3.1-8B | references/hf_model_card_frontmatter.sh | jq -s 'map({id, license, has_extra_gated_prompt})'`
+
+## High Level Endpoints
+
+The following are the main API endpoints available at `https://huggingface.co`
+
+```
+/api/datasets
+/api/models
+/api/spaces
+/api/collections
+/api/daily_papers
+/api/notifications
+/api/settings
+/api/whoami-v2
+/api/trending
+/oauth/userinfo
+```
+
+## Accessing the API
+
+The API is documented with the OpenAPI standard at `https://huggingface.co/.well-known/openapi.json`.
+
+**IMPORTANT:** DO NOT ATTEMPT to read `https://huggingface.co/.well-known/openapi.json` directly as it is too large to process. 
+
+**IMPORTANT** Use `jq` to query and extract relevant parts. For example, 
+
+ Command to Get All 160 Endpoints
+
+```bash
+curl -s "https://huggingface.co/.well-known/openapi.json" | jq '.paths | keys | sort'
+```
+
+Model Search Endpoint Details
+
+```bash
+curl -s "https://huggingface.co/.well-known/openapi.json" | jq '.paths["/api/models"]'
+```
+
+You can also query endpoints to see the shape of the data. When doing so constrain results to low numbers to make them easy to process, yet representative.
+
+## Using the HF command line tool
+
+The `hf` command line tool gives you further access to Hugging Face repository content and infrastructure. 
+
+```bash
+❯ hf --help
+Usage: hf [OPTIONS] COMMAND [ARGS]...
+
+  Hugging Face Hub CLI
+
+Options:
+  --help                Show this message and exit.
+
+Commands:
+  auth                 Manage authentication (login, logout, etc.).
+  cache                Manage local cache directory.
+  download             Download files from the Hub.
+  endpoints            Manage Hugging Face Inference Endpoints.
+  env                  Print information about the environment.
+  jobs                 Run and manage Jobs on the Hub.
+  repo                 Manage repos on the Hub.
+  repo-files           Manage files in a repo on the Hub.
+  upload               Upload a file or a folder to the Hub.
+  upload-large-folder  Upload a large folder to the Hub.
+  version              Print information about the hf version.
+```
+
+The `hf` CLI command has replaced the now deprecated `huggingface_hub` CLI command.

package/bin/skills/hugging-face-tool-builder/references/baseline_hf_api.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""
+Ultra-simple Hugging Face API example (Python).
+
+Fetches a small list of models from the HF API and prints raw JSON.
+Uses HF_TOKEN for auth if the environment variable is set.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import urllib.request
+
+
+def show_help() -> None:
+    print(
+        """Ultra-simple Hugging Face API example (Python)
+
+Usage:
+  baseline_hf_api.py [limit]
+  baseline_hf_api.py --help
+
+Description:
+  Fetches a small list of models from the HF API and prints raw JSON.
+  Uses HF_TOKEN for auth if the environment variable is set.
+
+Examples:
+  baseline_hf_api.py
+  baseline_hf_api.py 5
+  HF_TOKEN=your_token baseline_hf_api.py 10
+"""
+    )
+
+
+def main() -> int:
+    if len(sys.argv) > 1 and sys.argv[1] == "--help":
+        show_help()
+        return 0
+
+    limit = sys.argv[1] if len(sys.argv) > 1 else "3"
+    if not limit.isdigit():
+        print("Error: limit must be a number", file=sys.stderr)
+        return 1
+
+    token = os.getenv("HF_TOKEN")
+    headers = {"Authorization": f"Bearer {token}"} if token else {}
+    url = f"https://huggingface.co/api/models?limit={limit}"
+
+    req = urllib.request.Request(url, headers=headers)
+    with urllib.request.urlopen(req) as resp:
+        sys.stdout.write(resp.read().decode("utf-8"))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())