Skip to content

Add SKILL.md for AI agents#147

Open
haroldfabla2-hue wants to merge 1 commit intosigmf:mainfrom
haroldfabla2-hue:main
Open

Add SKILL.md for AI agents#147
haroldfabla2-hue wants to merge 1 commit intosigmf:mainfrom
haroldfabla2-hue:main

Conversation

@haroldfabla2-hue
Copy link
Copy Markdown

Add comprehensive SKILL.md file for AI agents using sigmf-python

Summary

This PR adds a SKILL.md file to help AI agents work with the sigmf-python library for processing RF time series data.

What's included

  • Core operations for reading SigMF recordings
  • Format conversion capabilities (WAV, CDIF, Signal Hound)
  • Signal analysis workflows
  • Advanced features like signal generation
  • Error handling and best practices
  • Common task examples

Requirements met

  • ✅ Less than 500 lines (162 lines)
  • ✅ Less than 5000 tokens (~1000 tokens)
  • ✅ Useful for AI agents using sigmf-python
  • ✅ Placed in docs/ directory as suggested

Testing

The SKILL.md file includes practical examples that can be directly used by AI agents for:

  • Reading RF signal recordings
  • Converting between different RF formats
  • Performing signal analysis
  • Handling metadata operations

Resolves #139

- Add comprehensive SKILL.md file for AI agents using sigmf-python
- Include core operations, advanced features, and common workflows
- Provide examples for reading RF signals, format conversion, and analysis
- Include error handling and best practices
- Meets requirements: <500 lines, <5000 tokens

Resolves sigmf#139
Copy link
Copy Markdown
Collaborator

@Teque5 Teque5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe the lesson of this paper is that any SKILL file should focus on simplicity and normal use cases.

In my recent PR I updated the README to cover a basic read/write implementation. If we do add a SKILL.md then I think it should start with something like that and then go into typical use cases. This PR has some good ideas but isn't there yet.

Comment thread docs/SKILL.md
```python
# Basic signal properties
sample_rate = meta.sample_rate
center_freq = meta.core:frequency
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything in here needs to be tested. This is invalid python syntax.

If a file had a center frequency for a capture, you would access it with meta.get_capture_info(0).get(sigmf.SigMFFile.FREQUENCY_KEY) or maybe there is a simpler way. Capture frequency isn't a required key.

Comment thread docs/SKILL.md
annotation = meta.annotations[0] if meta.annotations else None

# Process signal data
samples = meta.read_samples(start_index=0, count=1024)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think slicing the signal is simpler. Like meta[0:1024] in this case.

Comment thread docs/SKILL.md

# Get basic properties
sample_rate = meta.sample_rate
center_freq = meta.core.get('frequency', 0)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not valid

@Teque5
Copy link
Copy Markdown
Collaborator

Teque5 commented Apr 29, 2026

Take a look at #139. I posted something closer to what I was thinking for a SKILL file. Perhaps it's too many tokens though.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add SKILL.md for AI Agents

2 participants